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1 Introduction to Starburn 



This document describes the Starburn Technical Architecture. The Starburn Technical Architecture Is 
a collection of architectural Improvements, features, and applications that both integrate Into and 
extend the existing DeltaV System. The architectural improvements address issues related to 
multiple site development, product releases, verslonlng. languages, scalability, extensibility, 
performance, and broadening the range of target Ul devices. The architecture is being designed to 
more fully support new features and applications related to Abnormal Situation Prevention, Improved 
Alarming, Simulation, and Improved Control. All of these architectural improvements and features 
come together to provide a completely new Operator Interface and Runtime Workspace. 

This document describes the architectural enhancements required to realize the objectives of the 
Starburn program. 

1.1 Background 

1.1.1 Operator Interface 

The current DeltaV System includes Intellution's IFIX software integrated in as the DeltaV Operator 
Station. The software provides both display configuration as weii as a runtime workspace. The 
runtime workspace is able to integrate DeltaV applications as well as 3"* party applications. The 
current DeltaV Operator interface Software has been successfully used to integrate DeltaV. PROVOX 
and RS3. It Is also cun^entiy being used to Integrate Bailey, Telepemn. and most recently, Honeywell 
operator functions. The current Operator Software features are well described in the user 
documentation available with DeitaV. 

Since the original vision for DeltaV there have been many Innovations. On the Operator interface 
front there is shift towards scalable graphics, "smart" process elements, integrated help, and 
application Integration. There is an expectation that Operator Interfaces be able to run In either 
dedicated or non-dedicated mode as well as in thin client mode. With the recent explosion in Ul 
technology there is also the expectation that Operator Interface capabilities be available on a wide 
range of devices. All of these interfaces need to be robust and secure. 

The vision for these features is described In the following document: 

$/Hawl(/Starburn/Vision/HLT Starbum SUI.doc 

1.1.2 Architectural 

The original design of DeltaV was heavily biased by the object-oriented technologies available at the 
time the architecture was created. The promise was that heavy use of inheritance combined with 
other OO features would increase code sharing and In-turn reduce the amount of code written. The 
dilemma this creates is this - although heavy use of inheritance and code sharing reduces coding 
effort, It Increases dependencies. These dependencies extend all the way through the build and 
release images. An example should help to illustrate this. 

In the current DeltaV system applications and supporting database and runtime services are all tightly 
bound together. On the configuration side ail client applications are built on a common set of data 
components representing data in the database. Any change to the data components means that 
client applications must be rebuilt. These things make it difficult if not Impossible to version 
applications Independently of the database and runtime. It is also virtually impossible to move the 
development of any single application to another development site because of the intendependence of 
the client data components. The database, runtime, and system must be built as whole and released 
as a single Install Image. 

The solution is to divide the system into loosely couple services with layered independent applications 
(OO techniques will continue to be used). Each service has clearly defined external interfaces that 
can be Individually tested and versioned. Applications can be built independently. By drawing lines in 
the sand judiciously a balance between loose coupling and development effort can be found. 



8 



The downside is that there will be more duplication of code - in some cases the same classes will 
exist in several projects. This is a fair price to pay for the independence created between applications 
and development teams. 

Another objective presented later in this section deals with regression testing. In the current system 
there Is limited support for regression testing above the lowest levels in the system (e.g. database and 
contra] layers). The fact is that since the user interface is tightly bound in with the client data 
components any such testing would be extremely difficult to maintain. In the architecture described 
here all of the interfeces should be able to be fully tested. 

1 . 1 .3 Organizational 

Other factors are also at play - the development group that created IFIX Is no longer part of the 
Emerson Process Management group. To offset this as well as address the large increase in scope 
described in the vision document a new development group in Manila has been created. 

At the same time the development group in Pittsburg has a strong interest in utillzating several of the 
developments to enhance Ovation. In return developments from that group should be able to be 
integrated with the core DeltaV System. 

1.2 Vision 

Starbum includes a combination of enhancements to the basic operator environment as well as 
enhancements to the control Infrastructure to support new predictive functions. The vision begins with 
an overview of cunrent products and then adds in new Starbum features. 

Process Controt Systems are made up of many components. At the plant floor level are controllers, 
field devices, various lO Interfaces, digital and/or combined analog/digital buses, etc. The field 
devices and bus devices, for example, valves, valve positioners, switches and transmitters (e.g., 
temperature, pressure, level and flow rate sensors), perform process functions such as opening or 
closing valves, measuring process parameters, etc. Newer devices tend to be smart field devices. 
These smart field devices in addition to measuring signals and controlling final elements, can also 
perfomn control calculations, alarming functions, as well as other functions. Dedicated controllers In 
this model both execute control strategies and coordinate control strategies executing on field buses. 

Information from the field devices and the controller is made available over a data highway to operator 
workstations, data historians, report generators, centralized databases, etc,. These operator 
workstations run applications that enable an operator to perform functions with respect to the process, 
such as changing settings of the process control routine, modifying the operation of the control 
modules within the controller or the field devices, viewing the current state of the process, viewing 
alarms generated by field devices and controllers, simulating the operation of the process for the 
purpose of training personnel or testing the process control software, keeping and updating a 
configuration database, etc. 

A configuration database, which resides in the ProPlus, enables users to create or modify process 
control modules and download these process control modules via the ACN to dedicated distributed 
controllers. Typically, these control modules are made up of interconnected function blocks, SFC's, 
PLM*s, Equipment Modules. Units, etc which perform functions within the control scheme based on 
inputs and which provide outputs to other function blocks within the control scheme. As part of the 
configuration function users create/change process graphics. These process graphics run inside a 
dedicated runtime workspace or in some cases, containers that load into Internet explorers. 
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Process Graphics usually work together with other applications such as Alarm Banners, Alarm 
Summaries, Trending, etc to provide a complete operators interface. These operator display 
applications are typically Implemented on a system wide basis. They typically execute in one or more 
workstations. Both pre-built displays and customer configured displays are used to provide 
Operations, Maintenance, and other groups with Information about the operating state of the process, 
process equipment, and devices. Typically, these displays take the form of alanmlng displays that 
receive alarms generated by controllers or devices within the process plant, control displays indicating 
the operating state of the controllers and other devices within the process plant, maintenance displays 
indicating the operating state of the devices within the process plant, etc. These displays are 
generally preconfigured to display, in known manners, information or data received from the process 
control modules or the devices within the process plant. Often displays are created through the use of 
objects that have a graphic associated with a physical or logical element and that Is tied to the 
physical or logical elements to receive data about the physical or logical elements. The object may 
animate the graphic on the display screen based on the received data to illustrate, for example, that a 
tank Is half full, to illustrate the flow measured by a flow sensor, etc. While the information needed for 
the displays is sent from the devices or configuration database within the process plant, that 
information has traditionally been used to provide a display to the user containing that information. As 
a result, all information and programming that is used to generate alarms, detect problems within the 
plant, etc. must be generated by and configured within the different devices associated with the plant, 
such as controllers and field devices during configuration of the process plant control system. Then is 
this information sent to the operator display for display during process operation. 

While error detection and other programming is useful for detecting conditions, errors, alarms, etc. 
associated with control loops running on the different controllers and problems within the individual 
devices, it is difficult to program the process plant to recognize system-level conditions or errors that 
must t>e detected by analyzing data from different devices within the process plant\ Operator 
displays have typically not been used to indicate or present such system-level condition information to 
operators or maintenance personnel. There is currently no organized manner of detecting certain 
conditions within a plant, such as fiow conditions and mass balances, as materials move through a 
plant, much less an easily Implementable system for performing these functions on a system-level 
basis. To address these limitations process and processing elements are being introduced into the 
DeltaV System. 

The execution environment for process elements is the Process Module. Process modules include 
behavior or methods, also called process algorithms that can be used to simulate and detect process 
conditions. Each process element is associated with a plant entity, such as a field device or some 
logical element, and includes a data store for parameters or variables associated with that entity. The 
process elements are coupled to the entity, either directly or through an extemal reference, to receive 
data associated with that entity. Each process element can also be coupled to other process 
elements within the Pi^ocess Module environment to send data to and received data from the process, 
process equipment, and devices. For example, a process element for a tank may be coupled to 
process element for pumps or flow transmitters upstream and downstream of the tank and receive 
data indicative of the upstream and downstream flows Into and out of the tank. A method associated 
with the tank object may detect or even predict abnormal conditions in the tank by, for example, 
comparing the level of the tank with the expected/simulated level in the tank based on the flows into 
and out of the tank. Process modules may include flow algorithms that can be implemented on the 
combination of entities to detect system-level conditions, for example, to detect mass balances, gas 
blending, flow conditions, etc. 

1.3 Objectives 

Starbum is collection of features, applications, and architectural improvements. Because of the 
magnitude of the development program development practices and procedures are also affected. 
The objectives for the program are described in the following sections. 



' Or remotely connected lO (i.e. Remote lO) and Controllers (i.e. Brick). 
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1 .3.1 Operator Interface 

The Operational Interfaces is being designed to run in both dedicated and non-dedicated mode. It will 
mn as a rich dient or as part of a browser style interface utilizing web services. It Is available on 
workstations, laptops, tablet PC's, handholds, and smart phones. These objectives are summarized 
below: 

1- Dedicated mode > Operater workspace supports a dedicated mode for use in control rooms or 
any place where the display arrangement needs to be fixed and/or access strictly controlled 
(i.e. Kiosk style application environment). 

2* Non-dedicated mode - Operational workspace supports a non-dedicated mode for use by 
configuration folks, engineers, plant management, and others where flexibility and the 
richness of the interface are more dominant features. 

3- Support multiple Ul devices. 

a. Operational interface supported on a wide range of user interfaces - including Rich 
Clients, Web Browsers. Handhelds. and Smart Phones.^ 

b. Support for new types of features such as integrated Voice and Video, new input 
techniques such as those used In Tablets. 

4- Data Sen/ices. 

a. Support real-time data sers/ices, embedded historian, alarms & events, etc. 

b. Support for external data services - specifically OPC. 

c. Support reading from XML files. 

d. Support access to other service interfaces (may be disabled in secure mode). 

5- Display Management and Reuse 

a. Process Graphics will be able to be able to utilize composite structures. 

b. Displays can be set up and managed as part of the Class-based control hierarchy. 

6- Integration of Control, Alarming, and Abnormal Situation Management - 

a. Integrated Batch Operator Interface. 

b. Integrated Advanced Control Operator Interfaces. 

c. New applications - Route Management, Efflciency Calculations, Optimizations, Mass 
balance, etc. 

d. Integrated Abnormal Situation Prevention. 

7- Integration of S'^ Party Applications 

a. Improved integration across Applications. 

b. Decoupling of applications from the DeltaV core subsystems. 

8- Support multiple DCS's 

a. Support real-time data from multiple systems, e.g. DeltaV and PROVOX. 

b. Support alarming from multiple systems, e.g. DeltaV and PROVOX. 

9- Trending 

a. Full support for reading from DeltaV Historian. 

b. Full support for writing to DeltaV Historian - specifically Lab Data Entry. 



^ Will become the new Operator Interface. 



11 



1.3.2 Process Modules 

10- Improved Control 

a. Mass Balance. 

b. Energy Balance. 

c. Simple Composition. 

d. Custom Calculations. 

11- Abnormal Situation Prevention 

a. Using improved control calculations generate alert messages. 

b. Integrate specialized calculations from other Emerson Process Management 
divisions. 

c. integrate specialized calculations from 3^^ parties or customers. 

12- Reduced engineering efforts 

a. lO and Process chieckout. 

b. Elimination of duplicate display and simulation configuration when engineering 
systems with simulation requirements. 

13- Framework for Operator Training 

a. Process Graphics that can be used for process simulation and process calculations. 

b. Process Graphics include dynamics from both Control Environment as well as 
Process Modules. 

14- improve Integration with High Fidelity Simulation Applications 

a. Interface for exchanging runtime configuration. Included in the exchange will be 
parameter reference information and data type information. 

b. Interface for exchanging Operator Commands. 



1 .3.3 Technical Architecture 

15- Support Versioning - ship versions of applications separate from core system^ 

16- Deploy hot fixes and service packs. 

17- Common usability guidelines across all applications and development sites. 

18- There are now four development sites around the world (Austin, Leicester, Pittsburg and 
Manila). The aim is to allow teams at these locations to pursue independent development 
within the cycle of OeltaV releases. It should be possible to move the development of parts of 
the system to a different geographical location and not introduce source code dependencies 
between the sites. 

19- Future releases of DeltaV will comprise of a core system and a suite of applications. The core 
system will be presented in the form of a series of services. It will be possible to release 
versions of the applications independently to the core services. Applications and services 
must interoperate between versions. Applications must connect to services that are at most 
two versions behind and services must continue to support applications that are two versions 
behind.^ 

20- Partition functionality into functional groups. 



We will need to build-in comprehensive support for our call center and service staff for them to cope 
efTectively with this. 

Additional level of system testing will be necessary to ensure all the versions that are re(|uir^ really do work 
together. 
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a. Function groups need to be kept separate so that we can develop independent and 
potentially move things around. 

b. Example - Browser is a functional grouping. A Browser framework is provided. All 
applications implement their own browsing support by Implementing the interfaces 
provided as part of the Browser Framework. 

c. stmcture of the commands DLL 

d. Structure of drag and drop (some kind of Type/Handle base). Need a common 
system-wide spec. 

e. copy/paste 

21- Run or transfer several of the applications to Ovation 

a. Process Graphics needs to run on top of Ovation (also need Browser Framework). 

b. History needs to run on top of Ovation. 

c. Browser Framework needs to be transferable to Ovation. 

22- Run several of the applications on top of competitive systems. 

a. Operator Workspace 

b. Advanced Control 

c. Custom Function Blocks 

23- Localization separated out from builds (base build, localize using a toolkit - needs 
sophisticated tools than can allow dialogs to be re-worked to accommodate differences in 
languages). 

24- Be able to move projects between sites. 

25- Every service and application needs to have full regression tests built as part of the 
development. Every developer is responsible for developing tests for the test rig. 

26- Native support for Longhorn service architecture and scalable graphics. 

27- Support a wide range of Ui devices. 



1 .3.4 Deployment 

28- Full install off of DVD 

29- Layered applications 

30- Service packs 

31- Hot fixes 

32- On-demand deployment 



1 .3.5 Development Practices 

33- Support for several releases being done at the same time 

a. Starburn 

b. Safe 

c. Zones 
d. 

34- Austin performs a base build incorporating database code from Leicester. Other sites 
develop applications and extensions. 
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35- Localization can be performed after the core system is buiit. 
3S* OeltaV can be released in several manners 

a. New system from mfg Installed with DVD or install Image 

b. Applications released after the base system - don't require service upgrades 

c. Functional enhancements 

i. update the database 

ii. new runtime service 

ill. new configuration application 
iv. new displays 

d. Bug fixes 



1.4 Definitions 



Term 


Definition 


Service 


A reusable segment of business functionality which supports a 
significant portion of an Important business process. A service is an 
II ikci loiiifC uiieicsu uy d VfUiTipuneni — lis service inierrace is compriseo ot 
the service methods which together form the protocol of the service. 

individual service methods are rarely used in isolation. A single use 
case may combine the sen/ice methods of several services within its 


Framework 


A class hierarchy providing common behaviors and properties that can 
be inherited for specialization. 


Pattern 


A recurring theme in design, implementation or organization that is 
known to be effective and hence is documented so that it can be 

reused. 


Component 


Components are a vehicle by which services can be implemented. 


Graphical IF 


Any Graphical User Interface that participates in the display creation 
and viewing using the tools described in this document. 


Operator IF 


Graphical User Interface specifically designed to support Operator 
Functionality. Includes Alarm Summaries, Alarm Banner, Faceplates, 
and Dynamic behavior as is used today by current DeltaV users. 


Web-based IF 


Graphical User Interface that runs inside Intemet Explorer. Currently 
the approach is to use XAIVIL. 


Smart Handheld 


Graphical User Interfaces such as Compaq's IPAQ. 


Smart Phone 


Text and Graphical User Interfaces that run on new Smart Phone 
platforms. 


Process and Processing 
Elements 


Tagged graphical items that can be referenced by other configuration 
items as well as the runtime. They are normally equipment items such 
Pumps, Valves, Tanks, Reactors, etc. 


Smart Process Links 
aka Streams 


Smart Process Links are also referred to Streams in other simulation 
and optimization packages. Streams can have compositions 
associated with them. When they compositions associated with them 
the compositions flow along the stream through the Process Elements. 
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Streams can be referenced by the runtime. They are most often 
associated with Pipes. 


Process Algorithm 


Similar to existing algorithm types. Process Algorithms are defined for 
generalized use for certain kinds of problems (e.g. FBD's are designed 
for continuous loops). New algorithm types include Mass Balance, 
Routing. Efficiency, Optimization. Economic Calculations, other. 


Process Module 


Have special properties including. Mode, Status, and Alarm Behavior. 
Can be assigned to workstations. Execute process flow algorithms. 


Process Database 


Stores information about Process Elements, Streams. Algorithms, and 
Modules. The database will allow users to define multiple views 
against the same database items - for example Several Process 
Graphics and Algorithmic views referring to the same set of Process 
Equipment. 


Display Management 


Manage graphical displays from within the DeltaV configuration 
system. This includes display assignment for download purposes, 
download status indicators, and version control. 


Display Classes 


Associating display classes with module classes allows displays and 
binding tables to be defined just once on a Module Class basis. 
Binding tables for each Module Instance created from that Module 
Class would be created automatically. 


Graphics Primitives 


These are built into the display configuration model along with their 
behavior. These Include lines, polylines, ellipses, arcs, rectangles, text. 

imaoBS comonslts /arouDl Par^h nrimitiwp in thi^ ^Hitnr liac an ^AKill 
equivalent (although one editor primitive may be translated into 
multiple XAML objects, e.g. multi-line text, gradient filled objects etc.) 
User variables can be associated with any primitive. Variables are 
used by dynamic behaviors to control the algorithm and how items are 
displayed. 


Graphics Group 
(composite) 


Graphics primitives and other groups can be grouped together to form 
a grouped item which can behave as a single entity for editing 
purposes. User variables can be associated with any group. Variables 
are used by dynamic behaviors to control the algorithm and how items 
are displayed. 


Component Primitives 


Prs-built CQiTiDonent^ that hiifilt h\/ PPM anrl rlictrihiitoii 

components. Component Primitives have built-in behavior which can 
range from simple to complex. Component primitives have behavior 
which allows them to be configured. These components are for 
providing specialized interactions or controls. E.g. Trend controls, 

advance control Interactions etc. 


Process Graphic Item 

(aka - Library item, eittier 
Tempiate orCiass) 


Are pre-built single primitives or groups, including any defined 
variables and dynamic behavior. We will provide libraries of 
composites for common control equipment such as PUMPS. VALVES 
etc. Users can also create their own library of composites. Library 

itfifTlS can Ha tr^?)t#%H tAmnlst^Q in whi^h f^stea 9 ^nnw of tho itom ic 
■ ^^■110 1 U9 u caidj cia loi 1 i|.^iaica, ill wiiiv*ii wrci90 a lUU^jf \ji Uixs iidll 19 

made if it is placed on a display, or classes in which case a link to the 
library item is made if it is placed on a display. When an Instance of a 
class is created on another display the user can override the public 
parameters defined In the class, together with its viewport 
characteristics (position, size and rotation). 


Display 


A display is a graphics group which is capable of being displayed 
independently. It includes the definition of the "canvas" on which the 
display Is drawn (Its size, background color or background Image). 
Public variables defined for a display can be used as parameters when 
the display is called up. For example, the color of pipework for a 
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display could be controlled by a variable PIPEWORK_COLOR. When 
the display Is called up the parameter PlPEWORK_COLOR could be 
set to blue. 


DisDiav Class 


A display class is extremely similar to a display except that one or 
more of its public parameters are used as an alias in process value 
paths. For example, a display class could have process value paths 
including the alias MODULE (e.g. //#MODULE#/ATTR, FIELD). 
MODULE itself Is a parameter of the display. When the display is 
called up the parameter MODULE could be set to FIC-101A. 


Display Template 


Is exactly the same as a display except that it is placed in the library 
rather than associated with a particular equipment item, module, or 
item of hardware. A display template can be used as a starting point 
for creating displays. 


Configuration Application 


An application (.EXE) that is used to configure DeltaV. Examples of 
applications are: Explorer, Control Studio, and Recipe Studio. In 
general they are stand alone applications. Meaning that a DettaV user 
launches an application directly without having to first launch a 
workspace and then choose to load an application. 


Configuration Framework 


Collection of libraries, services and interfaces used by the Application 
developers to create a DeltaV configuration application. 


Docking Panel 


Docking panels are rectangular display areas which host a single 
application view. A docking panel provides functionality similar to that 
found in visual studio. This means that a docking panel has implicit 
behavior such as: 

o Dock/undock 
o Auto hide 

o urag/orop lo oiner paneis 

o Layout is persisted as user preference 


DataSource 


Abstraction of the data model that can interfaced to Client Models. 
Designed to work seamlessly with Dataltems. 


Dataltem 


Abstraction of the object that holds the handle or reference to the 
underlying data model, example the ClientObJectHandle for the 
ClientModel 







1.5 References 
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2 Process Graphics and the Operator Interface 
2.1 Objectives 

The objectives for Process Graphics are: 

1- Integrated - Process Graphic Displays is fully integrated with configuration, runtime, historian 
and other subsystems. 

2- Quick Edit/Runtime - Users will be able to quickly switch to a run-mode to see how the 
display they are working on will look at run-time. Both configuration and runtime views can be 
run simultaneously^. 

3- Ease of use - Process Graphics will be easy to use. Displays will be easy to call up on a 
wide variety of display devices. No display conversion is required to use displays on different 
devices. It will be easy to design displays for optimum usability on specific form factors. 

4- Best engineering practices - The system will be designed to facilitate re-use of displays 
and sut>-displays through both standard and user-defined libraries, display classes, etc, thus 
minimizing configuration and testing effort. 

5- Separation of the graphics from the scripting engine. The graphics and it dynamics are 
defined in data that are animated using both scripts (C#) and supporting Class-based 
Assemblies. Scripting engines are part of the Longhorn-based operating systems, Browsers, 
etc. 

6- Flexible data bindings - Process Graphic Displays can retrieve data from multiple data 
sources including Runtime. Historian. OPG. Sen/ices. XML Files, etc. 

7- Run on multiple systems — The Process Graphics implementation can be used with both 
DeltaV and Ovation. 

8- Smart Objects - Process Graphic Displays will fully support Smart Objects through Process 
Modules. 

9- Wide range of devices - Runs on a wide range of devices - all the way from dedicated 
smart phones up through multi-screen consoles. 

10- Longhorn Loolc/Feel - Designed from the ground up to take advantage of Longhom 
Look/Feel. 



^ The Process Graphics Editor will provide a quick run mode to test displays. This run mode will support most 
of the features available to the Process Graphics Runtime when run inside the Runtime Workspace. 
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2.2 Overview 



The operator interfaces for process control continues to advance. Current operator interfaces take 
advantage of high resolution graphics and multiple screens. Some of the operator interfaces are also 
being made available through browser style interfaces. 

Typically a graphic operator interface will consist of a series of process graphic displays that illustrate 
the pieces of equipment that make up the process. The primary advantage of such an interface is 
that more information may be presented to an operator in an efficient manner, i-lowever. the 
effectiveness of such interfaces depends greatly on the manner in which the graphic displays are 
structured in the system configuration. 

2.2.1 Static Graphic Components 

Soon after distributed control systems introduced support for graphic displays, an American National 
Standard was developed for Graphic Symbols for Process Display, ANSI/ISA-S5.5-1985. The stated 
purpose of this standard was to establish a system of graphic symbols for displays that are used by 
plant operators for process measurement and control. This was done to promote comprehension by 
the operators of the information that is to be conveyed through the displays, and to provide uniformity 
of practice throughout the process industries. The benefit of such standardization is a reduction In 
operator errors, faster operator training, and presentation of the process to facilitate use by the plant 
operators. This standard is followed by many companies and is suitable for use in the numerous 
industries. However, the standard's two dimensional line drawings have been made obsolete by 
advent of faster computers with graphics card supported by most system. High definition visual 
display units. VDU, are commonly available based on Cathode Ray Tube (CRT) or Liquid Crystal 
Display (LCD) technology that support 1280x1024. 1600x1200 or even higher resolution. Object 
orient software allows more complete 3D representation of process equipment. 

Cunrent control systems include a process graphic display editor and a comprehensive library of pre- 
buiit display objects with professionally drawn 3D representation of process equipment including 
pumps, valves, meters, piping, tanks, etc. Also, some systems may offer the capability to import 
graphics from a number of different sources including INtools, AutoCAD and Windows metafiles such 
as Visio vector drawings, as well as JPEG and BMP image formats. These components may be used 
to create a realistic representation of the process to which dynamic information may be added. An 
example of an operator display created using a library of 3D components is illustrated below. 
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Figure 1. Example operator graphic display that utilizes 3D components 



2.2.2 Dynamics Elements 

Predefined objects for information access are a standard part of graphic toot sets. Basic components 
such as knobs, dials, slide bars, and buttons that may be dynamically linked to information within the 
control system. In addition, a library of custom dynamos will be typically provided that may be used to 
access measurements, calculation, and analog and control components within the control system. 
Often these pre-engineered dynamos may be customized to fit the specific needs and standard of a 
plant. 

Dynamos typically provide the key parameters associated with measurement and control functions. 
For example, a dynamo used to display a control loop may display the control parameter, the setpoint 
and control output. Engineering units may be shown to provide context to a value displayed by the 
dynamo. The status of process alarms associated with the control may be reflected in the dynamo 
through color change e.g. background color of the control parameter value. Also, to eliminate clutter 
in the display, the fact that a loop is not in its designed/normal mode may be indicated through color 
change e.g. Units background color change. The ANS1/ISA-S5.5-1985 standard provides general 
guidelines on the color in a display e.g. Red is reserved to indicate an emergency situation such as 
Stop, highest priority alarm. The predefined dynamos provided with a control system may conform to 
this standard. However, these guidelines may not be consistent with the manner in which color has 
k>een used in a particular plant. In such cases, the colors used in dynamos may be modified to 
conform to the plant standard. 
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When the operator accesses a dynamo, then a faceplate may be automatically presented that 
provides further infonnation on the parameter shown. For example, when a dynamo associated with 
a control loop Is accessed, the faceplate presented to the operator may be used to modify the mode, 
change a setpoint or output. In addition, the capability may be provided to access further Information 
such as loop tuning by selecting a detail display reference. In response, another window will be 
provided from which detail Information about the control may be viewed. Which parameters in a detail 
display may be changed will be determined by the system security and the users authorization level. 
In some cases, operator access to information from a graphic display may be specified on a 
parameter by parameter basis. An example of a ^ceplate display generated by accessing a control 
loop dynamo is shown in diagram below. The associated detail display is also illustrated. 




Access to Detail 



Figure 2. Faceplate Accessed from a Control Dynamo 



Where the control system supports the use of aliases in the definition of similar pieces of equipment, 
the dynamic display components may also be designed to support dynamic referencing based on the 
piece of equipment selected for display. In such cases, pre-configured aliases and attributes may be 
used In place of an object tag or graphical attributes normally defined as part of the display object. 
Thus, aliasing supports a high degree of flexibility and re-usability since objects may connect to 
different I/O points and represent different graphical attributes, appearances, and security. Such 
capability may eliminate the need to re-building similar display objects. 

The use of a mouse in the operator interface must be considered in the Process Graphics design- 
Displays that use this type of interface will typically be designed to support both horizontal (below the 
display) and vertical (to the right of the display) toolbars. The default toolbars to support the following 
functions will be provided as a standard part of the Process Graphics: 

1 . Time and date display 

2. Alarm list with direct access to the display required to acknowledge the alarm 

3. Navigation to alarm summary, main menu, system status, last display, page back and fonvard 
and print 
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4. Alarm acknowledge, and silencing 



Using the page fbnA^ard and page back of the display toolbar; it is possible for an operator to access 
displays that contain information upstream or downstream of the displayed process. In addition, 
dynamos may be provided to allow another display to be accessed. Through the use of these tools. It 
is possible to create a display hierarchy from which an overview display may be used to access the 
key display In each process area. Within the process area, the ability may be provided using page 
forward/backward toolbar to pan through the displays within the process area. Also, using a dynamo 
for display access and trend window access, it is possible to provide the operator with 
startup/shutdown information and historical plots as illustrated below. 



Plant 
Overview 
Display 



Previous/Next Selection 




Area A 
Display 1 



Area A 
Display 2 



Area A 
Display n 




Dynamo Access 



Area B 
Display 1 



Predefined trend 
of key parameters 
in Display 



AreaB 
Display m 



Startup and 

Shutdown 

Procedure 



Figure 3. Example Hierarchy for Display, Trend and Information Access 



The graphics editor supported by the control system may allow animation to be incorporated into a 
graphics display. Using this capability, the static graphic component for process equipment may be 
modified to indicate the status of the equipment e.g. motor on or tripped. Also, animation may be 
used to represent dynamic data associated with the equipment such as showing the level of a tank 
using filling technique or show the status of an agitator through display change to indicate motion. In 
newer products, layer controls (send-to-firont, back, send-fbnvard, backward) may be used to show 
different information in the display based on the state of the process operation. 



2.2.3 Process Peitormance Monitoring 

The graphic display capability of the control system may be used to create special displays to allow 
the status of critical equipment to be easily monitored. Some examples of these types of 
requirements are: 



• First Out Indication on a process shutdown 

• Vibration Monitoring 

• Burner Management 

• Sootblower 
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• Safety System Status 



The associated displays can be structured to summarize the information. In some cases where 
moving equipment involves animation, for example a sootblower. animation may be effectively used to 
allow an operator to quickly access the operation®. 

The calculation capability of most control systems may be used to implement on-line calculation of 
operation cost, efficiency, etc. This type of information may be easily incorporated into the operators' 
graphic display so that he can use this Information to improve the process operation. An example of 
such types of calculations for a lime kiln operation Is shown In the figure below. 




• Animation is an important part of Operator Graphics. In the case described here, a simple animation showing 
the blower spinning is an effective visual indication to the Operator that the equipment motor is running. 
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Figure 4. Process Performance Included in Operator Graphics 



A variety of techniques may be used to integrate subsystem^ information in the control system. When 
this Is done the standard graphics and dynamos may be used to create operator displays to allow 
access to this information. In some cases 3D plotting of matrix values is required to show information 
(e.g. sheet gauging information). 

In special cases the information may need to be displayed in a manner that Is not supported by the 
control system. To address these special requirements the graphics display needs to support 
terminal services. 

2.2.4 "Smart" Process Graphics 

The discussion so far has centered around the use of Graphics, Faceplates, Detail Displays, 
Trending, and other aspects of Operator Interfaces that have evolved over time and are available in 
some form in most control systems. In Starburn, the base that the graphics are built on and 
something we are calling "Smart** Process Graphics. So what are ''Smart" Process Graphics? 

The term "SmarT originates from the vision document. In that document the vision calls for a new 
generation of graphic elements that have behavior that far exceeds what is available today. In the 
vision document these "Smart" behaviors have knowledge about how process elements are 
connected, have built-in behavior corresponding to the process element they are associated with, and 
are able to work together to predict abnormal conditions that would otherwise lead to failures, loss of 
production, etc. The concept document also introduced the notion "Smart" documents. Starburn 
addresses both the traditional operator interface functions as well as the "Smart" process behaviors 
described In the vision document. 

So whafs behind these "Smart" behaviors? How can displays which have a limited lifetime continue 
to provide this smart behavior even after they are unloaded from the system? What do displays have 
to do with smart documents? The answer to the smart behavior is that the Process Graphics are 
associated with process elements which in-tum execute inside a new kind of module called Process 
Modules. In this "Smart" environment several new types of process algorithms will be created. These 
process algorithms support new functionality for Gas Blending, Route Management, Efficiency 
Calculations, Optimizations, Mass balance, Simulation, etc. These new Process Algorithm types run 
Inside Process Modules at run-time^ Process Modules will be discussed in the next section. Smart 
documents allow users to create documents that embed Process Graphics in them. By specifying a 
point in time these documents can extract data from the historians. 

The relationship between process graphics, process modules, configuration, and supporting services 
is illustrated In the diagram below. 



^ The Subsystem in this context refers to an equipment subsystem such as gauge, motor starter, vibration 
monitor, etc. In the example used here a sheet gauge is used to measure the properties across a material, for 
example paper on paper machine or plastic being extruded from an extruder. The cross direction and machine 
direction properties are ideally displayed as 3D Plot - width, thickness, and time providing the X, Y, and Z 
coordinates. 

' The Virtual Controller will be changed to run inside the .Net Managed Environment 
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Figure 5. Starburn Applications Arcliitecturai 



2.3 Requirements 

The Starburn architecture for OeltaV focuses on a centralized representation (and database) for 
process plant objects, interconnections and layout information. The properties of these objects and 
Interconnections are broad enough (and probably extensible enough) to support a number of DeltaV 
applications, including: 

• Operator Interface "graphic displays" and other types of HMI applications 

• Process Module generation. The Process Graphics implementation needs to provide an 
interface and schema to support conversion from Process Graphics to Process Modules 
(the Process Module environment does the conversion and reconciliation). 

• Report generation. The Process Graphics implementation needs to provide an Interface 
and schema to support activation from a Report Generator. The Report Generator will be 
able to specify current time, an absolute time, or a relative time. When time Is not current 
values will be selected from the DeltaV Embedded Historian. 

• Highly automated "process rule" checking applications (e.g. mass balance calculations 
and detecting leaks, etc.). The Process Graphics system should be able to activate 
validation functions through the Process Modules verify functions. 

• Coordinating the use of shared equipment (e.g. dynamic unit allocation, resource 
management for material transfers, etc.) 



Particular attention is to be given to providing various HMI options for interacting with information from 
the DeltaV system, and from other systems providing popular well-defined interfaces (e.g. OPC 
interfaces). The range of HMI options are to include: 

• Rich-featured HMI. tailored to DeltaV. suitable as (our premier example oO a primary 
operator interface. 
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• Intra-net connected "remote", thin-client® primary or auxiliary operator internees for 
DeltaV and other compatible systems. 

• internet accessible "casual" (may be view only) HMI applications for OeitaV run-time 
information. 

• Specialized HIVIl applications involving wireless connections and portable devices 
(handheld, tablets, etc.) tailored to take advantage of the specialized features (and 
working within the limitations) of those devices. 



For users who employ several of these HiVll options, the goal is to significantly minimize their 
engineering effort; taking maximum advantage of the centralized database of plant objects, 
connections, and layout information for use with the various JHMI options. 

...and better integrate the operator functions currently provided by: 

• DeltaV Logon 

• DeltaV -desktop" 

• DeltaV Batch Operator Interface 

• DeltaV MPC Operate 

• Diagnostic Explorer 

• Process History View 

• Batch History View 

• (AI^S) FF Device Details application 



...and with new inter- and intra-net remoting features, largely remove the need for: 



• DeltaV Remote Operator Stations 

• DeltaV Web Server 

2.3.1 Primary Operator Interface for DeltaV 

Ultimately the Starbum HMI architecture must support the premier, full featured, high performance, 
primarv operator interface for the DeltaV system. Key requirements in this scenario include: 

2.3.1.1 Peiformance 

Promoted as the primary operator interface for DeltaV, we need this variation of the Starburn HMI 
architecture to be optimized for the best possible (display building) performance. This suggests: 

1- High degree of parallelism between data gathering and display rendering computations. 

2- Display configuration content optimized to help the data gathering problem. 

3- Minimizing server layers (e.g. working directly to ROC rather than OPC for DeltaV 
parameters) and RPC hops. 

4- Top to bottom optimizations (e.g. "parameter list** oriented request, not blocking on resolving 
EU ranges, etc.) 

5- Set of pre-englneered dlsplays^^ optimized for speed (e.g. avoid costly display objects, 
minimize animations, etc.) 



2.3.1 .2 Dedicated Operator Interface Workstation 

We need to continue to support those who want a locked>down, "captive*' operator Interface 
application as the ONLY application accessible (to most users) on a workstation ^\ 



* Here "thin-client" refers to any technology which substantially reduces the deployment and maintenance 
cost/effort involved in providing a HMI. 

The ones we use for benchmarks, or for display performance-sensitive customers in the demo room. 
" The Runtime Workspace provides much of the "locked-down" and "captive" behavior. 
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6- The HMI application has options to make it be autonr^atically started after the workstation 
boots. 

7- The HMI application has options to allow the user (with appropriate DeltaV security keys) to 
restart the workstation. The workstation restart process doesn't make it possible to use other 
applications. 

8- The HMI application has options to prevent the user from "escaping** or terminating this 
application. 

9- The HMI application does not provide a means for the user to generally manipulate 
flles/directones (e.g. the standard file browser dialog). 

10- The HMI application has options to allow the user (with appropriate DeltaV security keys) to 
start certain other applications (presumably also DeltaV applications designed to cooperate in 
the "captive" operator interface architecture.) 

11- In the extreme case, it is possible for the HMI application on a workstation to be configured so 
that the HMI application (and any child applications that it manages) Is accessible, even 
through workstation reboot operations. 



2.3.1.3 Specialized Operator "Console" Hardware 
We should continue to expect user requirements for: 

• Supporting ''multiple-head** operator stations, permitting more information to be on display 
(and more display management issues). 

• Utilizing function keys and/or auxiliary key pads to perform (user configurable) frequently 
used HMI Interactions. 

• Utilizing touch screens in addition to (or Instead of) a mouse. 

12- The tools for defining HMI displays must allow for displays sizes and aspect ratios suitable for 
*'multiple-head" operator stations. 

13- Users wishing to avoid display window placement and sizing actions for their operators should 
be able to define the HMI display "framework" for their "multiple-head" operator station. The 
HMI application uses the ''framework*' to position (and optionally scale) displays when they 
are built^^. Default frameworks (for typical 2 and 4 head monitor configurations, optimized for 
the pre-engineered displays) are provided. 

14- The HMI application provides a means for the operator move/pin displays in the framework, 
so that he can easily control the combination of display appearing at any time. 

15- Specialized frame properties can be set: 

• Batch operations display target 

• Process/Batch history view target 

• Unit/equipment module alarm summary target 

• Faceplate "bag" (dynamically selected set of N faceplates) 



2.3.1.4 Using Engineering Drawings for Displays 

Many "process graphic" operator displays are derived from existing drawings used to design the 
physical plant and Instrumentation system. Users face a number of barriers to utilizing these 
drawings (to decrease the engineering effort) for operator displays: 



• The size and aspect ratio for the operator displays do not align very well with plant 

drawings. The applications that render the operator displays may not have very powerful 
tools for dynamically adjusting scale, zooming or panning, so the drawings end up being 
unreadable or too difficult use. 



Frames in the framework can be configured with "auto-load" display, "do not change" and "do not obscure" 
properties, so traditional alarm banner and button banner type behavior is possible. 
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• Creating useful operator displays from a drawing (e.g. a P&ID) generally Involves the 
addition of many dynamic elements (digital readouts, bar graphs, selection/action targets, 
display navigation buttons for off page connections, etc.) If the operator display 
engineering tools cannot "understand" these drawings as anything more than bitmaps, 
they cannot offer much help to accelerate this process. 

• P&ID drawings often have content that Is not aiwavs useful In operator displays (e.g. 
manual control valves, instruments for manual readings, legend and description blocks, 
even the instrumentation symbols and connections may be more clutter than a well 
placed 1/2 size faceplate). 

• Managing the information (esp. the dynamic element) density is often the major design 
issue In creating operator displays, while it may not have been a consideration In the 
creation of the existing plant drawings. Therefore the if the resulting operator display 
would be too dense (or not dense enough), the "drafting" work invested In the plant 
drawings may be difficult to reuse. 



To help overcome these barriers, it suggests: 



16- We need "plant drawing importers" that preserve a richer data model of what the drawing 
represents. Presumably we should focus on wori<ing with the leading plant design packages 
(or at least the ones that would benefit Emerson Process Management service providers.) 

17- For systems/users who don't need a leading (expensive) plant design package, consider 
spinning off a version of the Starburn engineering tools that could be used to create P&ID 
drawings^^ 

18- To deal with the content coming from plant drawings that may not always be desired for an 
operator display, it suggests a means to segregate and sometimes hide some of this content. 
It would seem that the "layers" concept useful in CAD type drawings might be applied here as 
well: 

• Different types of plant drawing content would be assigned to different layers of the 
display. 

• The display engineer can add new display content (usually dynamic elements) to other 
layers of the display. He can then choose which layers will be included In the final display 
definition, and which layers show up by default (and which are included but hidden until 
an action is taken to make them appear). 

• A means in the HMI display rendering software (an advanced feature) letting the user see 
which layers are available, and to hide/expose the ones they choose. 

Net: the same display definition can be used for a display intended for "operating" (lots of dynamic 
elements) and a advanced user can manipulate layers to get a rendering that Is as close as possible 
to the original plant drawing. 

19- The display engineering tool relates tagged objects in the plant drawing (e.g. a FC-101 flow 
controller symbol) with a control module of the same name defined in the DeltaV 
configuration, and provides a means to easily add groupings of dynamic elements^^ showing 
the most important parameters of the control module. 

20- Similariy. for Process Modules, the display engineering tool relates tagged objects in the plant 
drawing with a process module of the same name defined in the DeltaV configuration, and 
provides a means to easily add groupings of dynamic elements showing the most Important 



Encouraging users to start their design process using our tools, so they arc starting the data entry process 
which will pay off for them in less work building displays. 

Seems like for any given module, a few standard choices would be available: single value (PV) w/ foceplate 
button, some sort of a graphical SP vs PV deviation element, a 1/4 size faceplate (2 digital values w/ top alarm), 
a 1/2 size faceplate (3-4 digital values, w/ mode and top 2 alarms) etc. . . 
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parameters of the process module. 

21- The HMl display rendering software has good scating/zooming/panning features^^ so that 
displays that aren*t perfectly designed to match the operator display framework 'View area" 
still work well. 

22- Make sure the HMl display rendering software accommodates identifiable "views" on "display- 
drawings" that are much bigger than the available framework view area. With 
scaling/zooming/panning features to create a view dynamically, it suggests that these 
"dynamic views" should be preserved in the sense of the "last display stack", etc. 

23- Special HMl display rendering algorithms that can help make too dense displays (too zoomed 
out) workable: 

• An adjustable "details lever which will prevent display elements that have shrunk below a 
certain size from being reduced below a minimum sized "target" or completely omitted 
from the display. 

• Making sure that most graphical elements representing plant equipment (vessels, pumps, 

etc, especially pipes) don't disappear altogether. 

• A means to identify certain "importanf* data elements as "shrink resistant" (they retain a 
readable size while other display elements shrink proportionately when zoomed out). 

• A means to test the zoom effects at display engineering time (no live data available). 



Net result: a highly zoomed out display still shows the major graphical elements (piping, vessels, 
pumps, etc.) sufficient to allow the user to choose where to zoom In, and optionally a few of the most 
important data values. 



24- "Display styles" that can be applied to display-drawings that determine things like: 

• color palette 

• background (tiled) bitmap 

• default "details level" setting 

• pipe. pump, vessel style (e.g. line drawing, filled, 3d with light source, etc.) 

• transmitter style 

• valve style 

• FF device style 

• HART device style 

• Interaction preferences (zoom gesture and behaviors, panning gesture, hover times, etc.) 



There should be the following levels of display styles that determine the final rendered display: 



• A system display style (determines the common display look, alarm priority colors, etc.) 
for entire system. 

• A rendering workstation (or device) display style, which can override properties in the 
system display style, to deal with color depth limitations in the rendering device, need for 
graphically simpler and/or higher contrast displays due to ambient conditions, etc. 

2.3.2 Internet-accessible HMl for DeltaV 

The primary objectives for an internet accessible HMl for DeltaV are: 



Including automatic scaling of font based information. 
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• Low cost (and low maintenance) accessibility to DeltaV HMI display information from 
virtually anywhere (I.e. from popular web browser(s) running on diverse platforms, 
connected via the Internet). Wide accessibility for "casuar* users (not intended as the 
primary operator interface for a DeltaV system). 

• Security for the OeltaV system by providing a view-only interface. 

• Must be able to use the **primary operator Interface** displays/drawings. (In most cases it 
will not be cost effective to have to (re)engineer a set of display definitions for this 
purpose.) 

• At the same time... "casual user** displays for Internet-connected users are likely to differ 
In design from the highly interactive **primary operating displays**. Suggests that these 
Internet-connected users would need means (via their Internet connections) to create 
their own displays: often managed separately from the "primary operating displays"^^. 



2.3.2.1 Client System Requirements 

To maximize accessibility from diverse platforms, and minimizing the effort to prepare a client system 
to use the DeltaV HMI, it suggests that the client ''system** is nothing (much) more than a web browser 
that is already likely to be in place. 

25- The client system application through which the Internet-accessible HMI for DeltaV is 

accessed will be a leading web browser application. Compatibility testing will be performed 
with: 

• Microsoft Internet Explorer 6.x (and later) 



26- There will be no DeltaV-related software HMI client software CD-ROM (or installation) 

required. Any DeltaV-related software required on the client system will be distributed over 
the Internet. Ideally any software needed for the Internet-accessible HMI for DeltaV (e.g. 
ActiveX controls. .Net assemblies, etc.) will be distributed/installed automatically when first 
needed on the client system. 



2.3.2.2 tntemet-accessibte HMI Features 

• View-only access to the DeltaV system. Cannot manipulate DeltaV parameters or 
perform any actions that change the DeltaV system or affect other DeltaV users.^^ 

• Display elements showing information from the DeltaV system will be rendered as closely 
as possible to that when the same display Is used on the primary operator interface HMI 
application. 

• Display elements used to cause changes to the DeltaV system (write parameters) need 
not be rendered as they will not be usable. 

• Display elements used to navigate to other displays will be rendered and when activated, 
will cause the display to change. 

• Alarm filtering 

2.3.2.3 Server Administration 

The administrator of the server for the Internet-accessible HMI for DeltaV must be able to: 



These "casual user" displays still need to be managed by the configuration system. To support this capabilty 
users can set up additional folders in the display system to store their displays. These displays will only transfer 
to workstations where the folders have been assigned. 

*^ Marketing is requesting that we replace our current Web-based interface. This interface does not allow user 
to make any changes. This interface is primarily used to support access for users who are 1) not allowed to 
interfere with the operation of the plant and 2) users who have full capabilities bur would like to have view-only 
capabilities when they are away from the plant. In some cases the Internet-accessible Process Graphics can also 
be used to support advanced features such as plant optimization, scheduling, etc where access is required to 
monitor the operating state of the plant. 
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• Control who may gain access to this feature (via user name and password authentication) 

• May view information on who Is "currently" connected 

• May control which user (or groups of users) have access to which displays (directories) 
2.3.3 Wireless (Handheld) HMI for DeltaV 

With greater experience using highly portable computing devices with wireless connections, we 
should expect to find more and more DeltaV users wishing to (and feeling comfortable with) applying 
those technologies to the monitoring and operation of their control systems. 



Possibilities would seem to Include: 

• For Tablet PCs: 

o Highly portable access to plant drawings that (when near an access point) have 

live (view-only) signal values and alarm information, 
o A secondary operator interface available conveniently available on the same 

device serving other functions (outside the scope of the DeltaV system) e.g. site 

inspection logs, machine maintenance administration systems, manufacturing 

execution systems, etc. 
o A primary operator interface in a (occasionally manned) remote "operators 

shack**. 

• For Personal Digital Assistant (PDA) devices: 

o Always accessible (view-only) monitoring of key system "health" or "production 

target" measures by plant supervisory and engineering staff, 
o Very task-specific control system interfaces for staff working in the plant^®: 

• Accessing a series of I/O values measured by the control system and 
verifying them with manual observations of the corresponding equipment. 

• While perfomiing minor maintenance on a reactor that is still in use, 
having a specialized *'gauge" to keep an eye on several key 
measurements (temperatures, agitator speeds, outlet flow rates): 
perhaps even to warn (annunciate) when a limit is crossed. 

• Using the control buttons in a faceplate to manipulate a control element 
(valve, motor, etc.) while observing the equipment to diagnose problems. 

■ Recording of "operator comments" while performing manual operations 
associated with a specific unit or batch. 

• For SmartPhone devices: 

o Widely accessible (view-only) monitoring of key system "health" or "production 

target" measures by plant supervisory and engineering staff, 
o Pager-style notification of significant system events requiring attention, 
o 

2.3.3.1 Client System Requirements 

As the capabilities (and size) of the wireless devices decrease, it would seem that there are more 
benefits to extremelv "thin client" applications in those devices; to minimize the consumption of 
resources in the device, and the effort to deploy the client applications to the device. 

On the PDA platform, use of Terminal Services technology (and the already existing Terminal Service 
Client) as the client-side application for DeltaV HMI would largely remove the client application 
deployment issue (and correspondingly reduce the need to develop (the skills in the organization to 
produce) applications for the PDA operating system (e.g. Pocket PC). 



Writing from PDAs, Tablets, and Smart Phones is a required capability. To support these requirements the 
security infrastructure in Starbum needs additional capabilities along the lines of Profiles in Windows XP and 
Longhom. 
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2.3.3.2 Tablet PC based HMI Features 



While the viewing area available in Tablet PCs Is comparable to those In traditional desktop 
workstations used as "operator stations", there are specialized features required in a HMI that works 
well on these devices: 



27- These devices support changing the display orientation from "landscape** to "portrait", so 
aspect ratios for display rendering is likely to be quite different (at times) than the "native" one 
chosen when the display was engineered. Would seem to require: 

• Particularly good zoom/pan features in the display rendering application (e.g. moving the 
stylus toward the edge of a display following a pipe causes the display to pan so user can 
trace where the pipe leads. A magnifier (something like the Windows magnifier) that 
follows the stylus showing that vicinity of the display in more detail; enough to read data 
links) 

• Support for selecting different display frameworks depending on current aspect ratio of 
the HMI managed display area. 

28- Keyboard-tess operation is probably the normal use mode. Suggests requirements for 
specialized data entry controls which have easy to use numeric keypads (or jog buttons, 
stylus, etc.) and/or specially designed confirmation actions to reduce the possibility of 
unintended data entry. More use of selection lists (e.g. to pick from operator selectable enum 
state names.). 



2.3.3.3 PDA based HMI Features 

The limited screen real-estate on PDAs means that many applications built for desktop systems are 
extremely difficult to use if directly transported (or used as a terminal client) on a PDA. This suggests 
some research into how to effectively design HMI applications (including ones that Involve critical 
Interactions with a control system) for that platform. 



29- More reliance on faceplate variations (e.g. 1/4 size) optimized to fit the PDA form factor. 

30- Ways of creating task-oriented displays dynamically (e.g. selecting parameters to add to a 
"Watch Window*'). A means to define local "annunciate rules'* to parameters being watched. 

31- Being able to dynamically change display styles (skins) (e.g. to get a high contrast style In 
difficult lighting conditions.) 

32- Alarm banners and alarm summaries optimized for the PDA display area. 
33- 



2.3.4 Display Configuration 

34- Store displays as XML scripts. This includes the following: 

a. DB adds support for a display object. Includes export/import support and making 
displays versionable items.^^ 

b. Ul adds download management (not downloading if a display is checked out). We 
would also check to make sure the picture Is checked In before doing a download, 
unless the user has checked the "download even if checked out" box. 

35- Displays are shown in DeltaV Explorer in Display Folders (and sut>-folders) under System 
Configuration. 

36- Displays, either class-based or not, can be assigned to both class-based and non-class- 
based modules. Currently Modules contain the following information: 

a. PRIMARY CONTROL DISPLAY 



Versioning is on the display level. This is already in place in DeltaV 7.3. This feature is for users who have 
enabled VCAT. 
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b. INSTRUMENT_AREA_DISPLAY 

c. DETAIL.DISPLAY 

These properties will be left as is. 

In addition, a list of (Display Type. Display/Display Class) pairs will be added. This way 
we can generalize the application of e.g. thumbnails, outlines, detail displays, faceplates, 
maintenance displays, or whatever types make sense. This potentially facilitates the 
runtime selection of sub-display based on equipment mentioned later. 

37- A formal interface will be used to handle check In/checkout management tied to displays. 

38- A DB-ID wili be assigned to displays. This allows us support VCAT behavior. 

39- Display File Names must be unique across the system^^. 

40- The display editor can be launched from DeltaV Explorer. 

41- Manage download indicators on the Operator Subsystem and the Displays Folders. This 
includes the following: 

a. The Operator Subsystem on Workstations will be used to provide download indication 
(i.e. displays need to be downloaded). 

b. The Display Folder under System Configuration (similar to Recipes) will also be used 
to provide download indication. 

c. The download indicator for non-class-based displays is set on all nodes where the 
display is assigned. This means that when a non-class-based display is updated 

• The Operator Subsystem download indicator trips on relevant workstations. 

• The download indicator on the Display. Display Category, and Displays 
Folder trips under System Configuration. 

d. The download indicator for class-based displays is set on a system-wide basis. This 
means that when a class-based display is updated 

• The Operator Subsystem download indicator trips on all workstations 
where control modules reference the class-based display. 

• The download indicator on the Display. Display Category, and Display 
Folder trips under System. 

e. Update download status will regenerate the download indicator on displays by 
computing checksums on the displays. 

42- Download options: 

Non-class-based displays are downloaded to alt workstations. This is the same behavior that 
current systems have. Users should be allowed to control exactly which graphics get 
downloaded to a workstation. 

a. Class-based displays follow the Area assignments for Units. Equipment Modules, and 
Modules on workstations. 

The context menu of a display in the library includes Download and the user can elect to 
download the display to all workstations to which it applies. 

b. Context menu of Operator Subsystem includes Download All displays. Download 
New and Changed Displays. 

c. Allow users to download all displays from the Displays Folder. This is consistent with 
a total system download. 



Since there are 100P*s of displays in a typical system is makes sense to provide a file structure in the runtime. 
The file structure used to store displays in the runtime is not yet known. 
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d. Allow users to download one Display Folder at a time. There Is no display like this 
today. This is consistent with Recipe Procedure/Unit Procedure/Operation 
downloads. Note all nodes where the displays are assigned will be downloaded. 

43- To support downloads a well defined download directory will be available on all workstations 
connected to the ACN. 

44- Displays wit! exist once per database, not once per system as they are now. If the active 
database is changed the whole system needs downloading anyway so that should not be a 
problem. 

45- Foreign documents can be associated with both Class-based and non-Class-based displays. 
This allows the Process Engineers to provide operating instructions associated with Displays 
that Operators could use to assist in using the item the display is associated with. 

46- The display runtime will load the display class and lookup the correct bindings for the item 
being instantiated in the runtime. When Invoked the display would be associated with a 
particular instance of the associated class based item in the equipment hierarchy. Most 
bindings would be relative to this but there may also be some absolute bindings. 

47- Changes to Delta V names will automatically be updated in the Display Binding Table and 
reflected in the download indicators. 

48- A Utility will be developed to covert non-Class-Based displays to Display Classes with Display 
Binding Tables. 

49- The display runtime will load the Display Class referenced in the Delta V Modules and lookup 
the correct bindings in the Display Binding Table. 

50- The Display Editor will allow for the definition of a Display Class as well as a thumb nail view 
of the Display Class. This will allow us to create a layered view (e.g. a Unit with Equipment ~ 
the equipment is shown as a thumb nail - when selected the equipment view opens up to full 
view). 

51- New maintenance displays will be created. These Class-based Displays will be associated 
with Nodes. Cards, Devices, etc. 

52- New conditioning monitoring displays will be created. These Class-based Displays will be 
associated with Condition Monitoring items such as Loop monitoring, Device Alerts, etc. 



2.3.5 Report Generation^^ 

The Starbum architecture must support a full featured report generator. Key requirements for the 
Process Graphics environment include: 

The foundation for improving plant operating operations and efficiency is the ability to accurately track 
the material and energy used in production, the final product produced and the efficiency of 
production. Such information is most useful when it is possible to view or trend historical values and 
to display total or averages over a period of time e.g. shift, day, month. Support for this type of 
information at the Operator Display is one aspect - but what happens if users want this information by 
shift, for last week, last month? This suggests the following: 



53- The Report Generator should be able to ask the Process Graphics system to load a display, 
pull data from the RT, Database, OPC, and other sources, and save itself into an XAMAL 
format suitable for embedding into a Runtime Report.^^ 

54- Other elements, such as trends and graphs, can also be included into the Reports. 

55- Since the users can specify time, the Process Graphics engine will be able to locate values 
and pull data values from the historian. 

56- Users can specify a specific time. e.g. hour, shift, day or monthly total or average. 



At this point we are thinking that we will use MS Word document format. MS Word is familiar with most 
users and it is a rich format. 

^ MS Word will support XAML format in the Longhorn time-frame. 
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57* Users can specify a relative time. e.g. an hour, shift, day or month total or average relative to 
the current hour, shift, day. or month. 

For example, by configuring a specific hour, then the value shown in the display will always 
correspond to that specific hour i.e. change once per day. However, by selecting relative 
data, then the latest total or average for that timeframe will be displayed. For example, if the 
graphic element Is configured as a relative hourly reference (with zero hours offeet), then the 
last hour total or average would always be displayed i.e. value would change at the end of 
each hour. 



58- The display system can request data from a wide range of services - RT. Historical. OPC. 
Events, as well as other sources. 

59- The following will need to be configured for the total/average graphic element: 

a. Path to the function or process block parameter. 

b. Total or Average Value Selection. 

c. Relative or absolute value desired. 

d. Relative offset to current (configured for relative values). 

e. Scaling ^ctor (in case the units of the measurement are not in minutes e.g. GAUHR. 
2.3.6 Conversion of Process Graphics to Process Modules 

A Process Module may be generated from a Process Graphics. !n this case the functionality available 
to the Process Module is determined by the Process Graphic elements. When the user configures 
their Process Graphic Display they have the ability to include additional information such as Mass or 
Energy Streams. This streams information Is also provided to the Process Module. 

Since Process Modules are a new type of OeltaV Modules, it is possible for them to reference, and t>e 
referenced by. DeltaV parameters, control strategies, displays, etc as illustrated below. Also, using 
this capability, it is possible for a process module to be created in DeltaV Simulation Studio 
independent of the Process Graphic Display. 
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Figure 6. Interaction of Process Graphics with Process Modules 



It is also possible to generate Expert and MSPC algorithms from Process Graphics - refer to the 
Process Modules section for details on this. 
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Key requirements in this scenario include: 

60- From the Process Modules Editor, be able to load a Process Graphic Display. 

61- Use the Process Graphic Display elements, together with it's Schema, to generate Process 
Module Elements. 

62- Preserve references that were configured into the Process Graphics as part of the Process 
Modules interface. 

63- Preserve type information, over-rides, etc from the Process Graphic Display. 
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2.3.7 Conversion of INtools to Process Graphics 

The Starbum vision document specified that we should be able to convert INtools P&ID's to DeltaV 
Process Graphics. Key requirements in this scenario include: 



64- Convert the P&ID graphics to Starbum Graphics. 

65- Preserve device and equipment information from the P&ID. 

66- Preserve information on how process elements are connected. 

IVe met with the Imegraph team in Huntsviile last year. The support we are looking for is available through 
their engineering Jramework. 



2.3.8 Browse 

The starbum Process Graphics environment maintains it's own internal schema. It uses it's schema 
to manage itself. In order for the DeltaV Process Graphics Editor, DeltaV Explorer, etc to browse 
displays the Process Graphics infrastructure will need to support browsing. Key requirements in this 
scenario include: 



67- Implement a Browse Interface specified as part of the Browse Framework. 

68- Allow Process Graphics to reference parameters internal to the display. 

69- Expose parameters at lower layers in a particular display as named parameters at higher 
levels in the interface. 

2.4 Display Technology 

2.4.1 Rich Display Client 

Rich display clients will continue to be used as they are today, i.e. for dedicated operator Interfaces. 
The same download scripts sent to rich clients also work with the web-based Ul's. 



Figure 7. Rich Client 



2.4.2 Web-based Client 

The Wet>-based clients read XML files. Dynamic behavior is provided through a combination of 
predetermined functions and C# Scripts. Data is transferred through to the displays over Web 
Services. 
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Figure 8. Web Client 



2.4.3 Smart Handhelds 

Smart handhelds can be also be supported. 




Figure 9. Smart Handhelds 



2.4.4 Smart Phones 

Smart phone investment is being driven by the consumer industry. New gaming technology is further 
driving the capabilities of these devices. Because of the extremely limited screen size and Iceyboard it 
will be necessary to provide specialized displays (postage stamps). The same configuration 
environment could easily generate these displays by providing hints on what the target display device 
will be (i.e. select canvas size). 
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Figure 10. Smart Phones 



2.5 Process Graphics Architecture 

2.5.1 Process Graphics 

Underlying Process Graphics is Microsoft's XAML implementation; XAML together with Indigo and 
WinFS are the key elements of the Longhorn operating system release. The XAML format specifies 
the properties of drawing elements for vector graphics commands. A XAML script can include static 
data as well as dynamic data. The dynamic elements and attributes can be associated with real-time 
values, historical values, physical properties such as mass-flow and composition, etc. In this sense 
XAML Is data driven. 

XAML vector images are stored as text-based commands. Since it is vector based, it is possible to 
have the same high quality wherever a display is rendered - whether on smart phones, handhelds, or 
high-end monitors. 

Since XAML is entirely text based it is convenient for DeltaV to store and emit as a download scripts. 
Using the same techniques used today for control configuration, it is possible to generate download 
status indicators, be managed as part of configurations, and participate In version control and 
upgrades. Process Graphics are downloaded In much the same way that lO and Control, System 
Setup data. Batch, Advanced Control, and SIS configuration scripts are downloaded today. Since 
Process Graphics are stored as text, it will also be convenient for users to search for text within 
images. 

At its core XAML supports vector graphic shapes consisting of straight lines and curves, images, and 
text. It supports the basic graphical shapes including rectangles, circles, ellipses, and polygons. It 
also gives developers the ability to control and implement animation techniques that can be as 
complicated as generating three-dimensional morphing effects to simple two-dimensional images. 
The graphical Information is stored in a sequence of commands that draw various vector graphic 
shapes. This Information can be converted by various methods to display an application-specific 
graphics image. Scalability is achieved without jagged edges because redrawing instructions are sent 
to the rendering program, rather than sent as pixel values in a bitmap. Rendering engines are defined 
for each target environment. 

Every XAML element and every attribute of an element in a Process Graphic Display can be 
animated. It supports bitmap-style filter effects for creating high-impact graphics. XAMUs filter effects 
give developers the ability to add effects directly to shapes and text in a manner similar to those 
achieved using professional imaging tools. XAML has the support for blending, tiling, transforming or 
rotating elements, morphing, offset, merge, and special lighting effects. Filter effects can be applied 
separately or In any combination on a vector image. Special effects such as mouse over features can 
be assigned to any XAML graphical object^^. 



We need to determine how much of this capability to expose in the first release. 
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XAML produces small file sizes that allow for fast downloading. Additionally, since DeltaV will include 
Groups. Composites, and Templates it will be easy to build up a large library of pre-built elements that 
users can use and add to. 

XAML can be drawn using data at run time that is derived from a number of different sources in a 
distributed computing environment. The data can come from DeltaV Runtime. DeltaV Historian, OPC, 
an XML file, or many other sources. To accomplish this an abstraction or a logic layer is created to 
establish the relationship of the data to the XAML graphic. For instance, suppose XAML describes an 
image that represents data In terms of pixels (e.g. filling a bar). The reautime data may be stored in 
units of degrees Fahrenheit. It would be necessary to establish some type of logical relationship 
between the image and the data that will be displayed in that image so the end user can view 
something in a format that is easily understood and not subject to misinterpretation. Build-in support 
from DeltaV will provide the scaling before the data value is rendered. 

The overall Process Graphics functionality is realized by two major applications. The configuration 
environment consists of Smart Process Graphics Studio. Smart Process Graphics Studio includes 
several tools that are used for creating graphics and graphic components and binding graphics to data 
sources. The second application is the Smart Process Graphics Server. The server provides back* 
end support for executing Smart Process Graphic Displays. These will be described in the following 
sections. 

2.5.2 Process Graphics Elements and Operations 

Process Graphics Elements are the basic infrastructure for Process Displays. Primitive Process 
Elements include the following: 



1- Shape Elements 



a. 


Rectangle 


b. 


Circle 


c. 


Ellipse 


d. 


Line 


e. 


Polygons 


f. 


Path 



2- Container Elements 

a. Group 

b. Symbol 

c. XAML script 

3- Text Elements 

a. Text 

b. Text path 

4- Reference Elements 

a. Image 

b. HTTP Link 

5- Ul Elements 

a. Button 

b. Check-box 

c. Slider 

d. etc 

6- Other Elements 
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a. C# Script 
b. 

For each Element or Element Group the user can define attributes. Example attributes include: 

1- Tool Tip 

2- Attach a Context Menu (could launch help from here) 

3- Define Drag/Drop behavior (e.g. drop a tag on a Plot) 

4- Zoom and Span 

Users can associate behaviors with Elements and Grouped Elements. Behaviors include: 

1- Action, Alert based on a lO Mapping 

2- Conditions such (if-then-else, switch) 

3- Scripts 

In the Process Graphics Editor Users can perform the following actions on Elements and Groups of 
Elements: 

1- Create, Copy/Paste. Move. Replace, Resize, etc 

2- Convert to Dynamics - any static element, or grouping of elements, can be converted to a 
Dynamic element. For example, a user may define a conveyer group, convert the group to a 
Dynamic Group, expose parameters related to the animation of the Conveyor, and add script 
to define the movement of the Conveyor. 

3- Add a Listener (register for an event and take action when the event arrives - e.g. press a 
button) 

4- LoadURL 

5- LoadXAML 

6- Print Element 

Actions that the editor can perform on Elements include: 

1- Cut/Copy/Paste/Delete Nodes and Elements 

2- Move to Back/Front 

3- Move One Fonvard/Backward 

4- etc 

Creating Groups 

1- Create Group 

2- Define which elements are to be made Dynamic 



40 



3- Define functionality for each of the Dynamic Elements 

4- Expose attributes that need to be bound to Inputs and Outputs 



Using Groups 

1- Drag Groups / Composites from Pallet 

2- Attributes that can be bound show up in the parameters view 
3- 



2.5.3 Process Graphics Configuration 

A new engineering environment will be provided for the creation of graphic displays. DeltaV Explorer 
will be modified to allow a user to easily find the displays that have been created. Displays may be 
viewed by process area. Using a new display editor, it will be possible to quickly create graphic 
displays. Standard 3-D elements^^ may be used to create displays that dynamically show 
measurements, actuators and process equipment simulation. Also, static elements and dynamos 
associated with control and calculations will be supported. The user may define display layers to 
address the Internee requirements of different users of the graphic displays. In addition, the 
capability will be provided in the display editor to create new smart 3D elements, dynamos and static 
elements. The display editor may be used to automatically generate process simulation based on the 
smart 3-D elements and their connections defined in a display. 

2.5.3.1 Explorer View 

The DeltaV configuration for a large process plant will contain numerous process graphic displays. In 
most cases, the operator for a given process area wilt need access to the displays associated with 
their area of responsibility. Through these displays, they may make changes to their process area. 
Also, an operator may need to view displays associated with upstream and downstream process 
areas that impact their process area. Other DeltaV stations in the control system may require access 
to all displays available to an operator plus additional displays for plant engineering, maintenance and 
operation supervision. 

Thus, to make It easy to engineer and maintain DeltaV graphic displays, displays will be assigned to 
the Operator Subsystem on workstations. Downloads will then work off of the Operator Subsystem. 
For example, the displays defined for AREATA will be shown in the hierarchy as illustrated t>elow. 



.'+:Sy^tern:Gonifigij^ , 

I . ' ♦^Ciintrol Strategies ^ 

^y^-.:- "y Display DireSory 
+:D1SP 1 



.♦OVERVIEW 




^ MLMOD 



•»- Physical Network 



^ 2D objects with 3D rendering. 
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•V Cbhtrol Network 

vV, ; f USAUST^OELLBERT ■ .i. 

. . + Assigned Modules • •,-1. ,. 

' : ♦ MLMOD " ^^ 

v - V. '-'t' Operator <<assign displays by dragging aress to subsy^^^ "^tV-X"^ 

. ♦OVERVIEW 



When a display is selected, then by right clicking a display name, the option will be provided to launch 
the Graphics Editor to view or modify the display. 

Also, when a display is selected the contents view In explorer will show the top level objects In the 
display. To support this the Process Graphics subsystem will need to be invoked to extract the top 
level elements from the stored displays. 

The status of each display (downloaded, not downloaded, unknown) will be indicated by the icon 
provided for each display name in this folder. Also, the icon will be used to indicate if the display is to 
be locked In mernory or whether it can be maintained in virtual memory on the disk. 

2.5.3.2 Process Graphics Editor 

The Graphics Editor is used to create new displays, composites, templates, dynamos, etc for plant 
operations, engineering and maintenance. This editor may be launched using the 
Start/DeKaV/Engineering/Process Graphics Editor selection. When the display editor opens, the user 
will be presented with a work area, toolbar, and multiple palettes of graphics elements. The operator 
display layer will be selected by default. To configure the operation view, Graphic elements may be 
dragged from the palette into the work area. The user connects the elements together by holding 
down the left mouse button over a connection point and moving the cursor to a destination connector 
(similar to what they do with Control Studio). The type of connection (Pipe. Conveyor or Duct) will 
automatically be defined by the definition of the starting connector. When a connection supports 
multiple types of connections, then the default connection type, defined through the toolbar selection, 
will be used. When a connection is being created, an elbow/bend will be automatically provided each 
time the mouse button is released before reaching a defined connector. Individual graphic element Is 
selected by clicking on or near its graphic representation. When a graphic element is selected, then 
the configurable parameters associated with the graphic element will be displayed in the lower left 
pane» as illustrated below. 
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Figure 11. Process Grapbics Editor 



Actuator and transmitter elements will have one or more function block references. By double clicking 
on these reference parameters, a dialog will be provided that allows the user to define the path to the 
desired 'control modules / block / parameter*. 

Common processing elements such as tanks, mixers, heat exchanges may be added to a graphic 
using the Process Equipment Palette. When such elements are added to the display, then they may 
be stretched to a size that is appropriate for the display. Also, by selecting an element, the number of 
input and output streams and their position may be modified through the associated parameters 
shown in the left pane, as illustrated below. 
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Figure 12. Using Process Equipment Pallet 



A Custom Equip palette of graphic components will be supplied for less common processing 
equipment. Also, the capability will be provided to allow the user to modify or define new Process 
Equipment components. 

Analog and discfete measurements that are included in the plant may be identified by dragging a 
transmitter or switch from the Measurement palette and positioning it over the associated stream 
(pipe, conveyor or duct) or a piece of equipment, as illustrated below. 
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Figure 13. Using IVIeasurement Pallet 



Through the configuration paranneters of measurement blocks, the user may select the colors applied 
to the device and the PV value background to indicate the state of a device (good or bad) and process 
alarms (in alarm an acknowledged or unacknowledged). 

A Special palette will be provided to show starting and ending points of a stream contained on a 
graphic and to alfow a graphic display to be represented within a display. Internal stream references 
allow the source of the stream to be named. External stream references include parameters that may 
used to identify the associate stream on another display. The thing that must be configured for an 
external output reference is the name. External input references configuration identified the Display 
and output reference associated with the input. One external reference parameter may be configured 
to reference an output parameter. The name of the display and external output reference Is shown on 
the associated external Input reference, as illustrated below. 
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Figure 14. Special Pallet 



The details associated with a unit within a process may be provided in a dedicated display. This unit 
may be included in another display be adding a Display reference. The name of the referenced 
display will be shown within the Display reference, as illustrated below 




Figure IS. Display Reference 
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By selecting the Eng/Maintenance layer, the user may define components that will be shown on the 
display if the person who logs into the node has engineering or maintenance privilege. For example, 
if on-line simulation of the process is implemented, then estimated stream properties or properties of a 
unit, such as calculated operating efficiency may be exposed using the Estimated Property element 
provided in the Measurement palette. For example, the calculated pump discharge pressure could be 
shown using the Estimated Property element, as illustrated below. 



2.5.3.3 Tree View 

The Tree View in the Process Graphics Editor is used to show the Elements. Groups. Composites, 
and other top level items (except parameters) in a Process Graphic Display. The user can expand 
elements in the Hierarchy in a manner similar to what they do with Control Modules. 

2.5.3.4 Parameter View 

The Parameter View In the Process Graphics Editor is used to show all of the parameters for the 
selected item In the contents or Tree View. Parameters that are to be bound for the purpose of 
Animation, Events, etc are included in the Parameter View. 



2.5.3.6 Dynamic Behavior View 

Users can add dynamic behavior to any display element. 



Need to add a few screens here showing how dynamic behavior is added. 




Figure 16. Engineering and Maintenance Views 
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2.5.4 Process Graphics Display Format 

A Process Graphics display definition is contained in an MSAvalon XAML file. This file represents an 
operator internee screen, and is loaded and processed by the edit and runtime applications. 

The file structure can be divided into two main sections: Display and Dynamics. These are contained 
in a paneMype MSAvalon Ul element (see {Panel} tag below) like Canvas, DockPanel, etc. 



<( Panel) 

xinlns="http://schemas,microsoft .coin/2003/xana" 

xmlnsidef**" Definition" 

>' 




. < (Panel) .Resources> 

<!--■ Begin Dynamics section — > 




<!-^ End Dynamics section — > 
. <•/ (Panel } , Re source s> 




" . 'ri'^^'l Begin. Display section — > • I • 

■ ■ .'v i^'?^'' ~r End '^Display section " / -* 
T\<-(i(^PaneJ.}> • ' ^v.iu .. - J.- " • ' . ■ rv 





Figure 17 - Process Graphics Display XAML File Structure 



2.5.4.1 Display Section 

The Display section defines the Process Graphics objects or figures that can be seen by the user. 
This consists of MSAvalon Ul element tags. For more information, please refer to Microsoft Longhom 
documents. 



<gahvas :-.•*,'•. _ •"•■;..■■*. , ; , • . . '. ' j ,.-^5^-■;±^';•"i:■- 



;; ;fXTOl^ . .com/2003/xaml'r' . 



V </Button> 



V Ji. End$Disi>Iay" section* 

" <yCanvas> • •■■'"r-*--' V 



■•3". fl.' 



■"I ;. ''<Canvas.Re30urce3> . ... ...... 4 

- : -<! --'.Begin Dynamics section — > ' ■ \ --^ 

'!"": -.<i7f"'^End Dyriamics section — > .^^ . . .. 

"0<*/Canvas^. Re sources >• • " \ 



• < !'r-: Be^ih Di^piay!-. section — > ■ : . - ^ i. 

7<Canvas ID=;!MyPic:" Canvas . Top="10" Canvas . Left="10"> • t' 'pr; rj'i 

v.. ,. j; . <Ellipse XD=^"Eai4psel*V. /> ^ '-f.. 

,<Line..'iD-".Linel", /> ■ .', • • • v:-- vT/i" < 



Figure 18 - Display Section 



2.5.4.2 Dynamics Section 

The Dynamics section defines the dynamic runtime behaviors of Process Graphics objects tn a 
display. In the current prototype implementation, there are three parts that make up the dynamics of a 
display: 
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• Dynamics Definition 

• Dynamics instances 

• Event Dynamics 

Each of these is defined as an XmlDataSource object in the Resources tag of the outermost panel. 
The XmlDataSource is used since it can contain custom XML data structures within an XAML file. 

<Canvas ^ .f *'.- 

xmlns'^^http: //schemas .microsoft .com/2003/xainl*' 
xmlns :def-"Defdnition" 

"•'>"• • . V . 

/<Canvas . Resources> 

• "<! -r' Begin "Dynamics Definitions — > .- \[ 

<XrolDataSource def : Name«-" Dynamics Def" XPath="Dynamics"> • . -.J -' / = 

' ■ ;^ * .<Dynami<i:s xmlns=""> '.' 

H.-. .*.' </Dynciinics> 
. " •/ < /Xml Data Sou rce> . : 

• .:<' — ; End pynamics Definitions — > \ ■ ■ ... ^ ^^^L 

ri ^J'^/}!-'< ■ — vBegirilDyhamics Instances — ^> / . 

■''.?-^^^f^§J^-^:<^lDataS^ INST {NAMEl-}":" XPath='"nvn;*nni t-<iTrx-^t.A^r^f^ii^s^^- 



• Dy nami cs Ins t arice£^:^|f.:!;'j:;' . , 



<pynainlGs Instance xmlns=""" .. . .> 

• fj. 7" v.;i • </ Dynamics In stance> ■\^^/* ' ^ / 
• .. ••;■;* </XmlpataSource> ' *>v Jv 

• <XmlDataSource def :Name="DYN_INST_{NAME2}" XPath="DynamicsInstancer>^ ^ 
•<DynamicsInstance xmlns-"" , . ,> . 

V . • - ..- . . . •. ■ - 

• . / ^ ,.</Dynanii«csInstance> ; . 

' :;• . </XmlDataSpurce> 
. ,\-"Hj^ ; " End Dynamics Instances . — > • : J 

-Ifvi: •>?:.*:.^< ! -- Beg irtjc^! vent Dynamics .--> /--s- /; 

• '(^^^^ XPath=i"EventDynamics"> ii 45^^^^^ 

!;-.-l^p>f v^CEventiPynamics xmlns=*'" .'..>'. [. " ' "■ -". 

- :V"""^:i^^^^.'^ </XmlbataSource> • ' • 

/?: <XmlDataSburce def :Name="EVENT_{NAME2 }" XPath^" Event Dynamic s">:^ v^tx'-f^^^^^^ ^ 
V^' <Event Dynamics xmlns="" ..,> . i " '"MSi ' 

•v^ijivv'-i-L-". .• '</Eventpynamics> . ■ ' r •« . .rv ;.•:!;|;S^*if::'.^•^^^ :^>^ 

['^V' 'j-;/'j;--'"<^ Dynaimic^>--r> : ' ; * i Vyif; . C". V-^^ .^-^ • 

■ ,<-/Canyas . Re sources > ' ' . '" '. ..T' .^'l /^^^t-,^''': - v^.- --'^ 

■.5/<l~~ Begin Display section :: — > 

^ <!-7 End Display^ section --> C^-"'-'^ ..^ .. 

■ ■'■•^^-r: ■ • ■■i:4:f ^ .■. . . ■ -j.. ' ■ - • "^V 

Figure 19 - Dynamics Section 
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2.5.4.3 Dynamics Definition 

The Dynamics Definition contains all the dynamics definitions to be used in executing the runtime 
behaviors of a Process Graphics display. The Dynamics Definition section is defined using the 
IVISAvalon XmlDataSource object tag with the defiName "DynamicsDef. Except for the content within 
the CDATA section, the XmlDataSource tag attributes, values and structure must follow the one 
shown below: 

<XinipataSburce def : Name=" Dynamics Def" XPath«" Dynamics *•> .' 
<i}ynamics xmlns=»""> 
<! [CDATA ( 

function SWITCH (cur, vail, val2r test, testval) 

{ .. . 

if (test — testval) ■ j- ■ * . ■ 

.-. • . • return cur; - * 

If (cur == vail) 

„ • t return val2; . • 

: eXse . . - . ^;\ ■ ^T." ■ 

•-•?•:'••'? i .r -^K • •• ^ '\ w -"^i^ ;• v'^; - 



. • .func€i:bn'^ADD(vall, val2) ■•n'^. 

re turn jvall + yal2; * = !* j • ^ 

function ADD__MAX ( vail, val2, vaimax) * " ' . : - 

'. ■ .^^.li i - . . ■ . r ..^ . • •^ 

.V- ^/v.■•■^ • ■ • . y^?^ sum - vail val2; • ; . _ * "^ '- 'r Xr/- '!^ '-- 

r '^-^^Y^i-i^.y:: :--.4f v-l siim > vaimax) . . • ' * . -^^^i^' .7 S >V?i£?!l:!;r-:v r^ 

' \/^i;i:\^T^'. '■' ■ ■■'returiV' s ■ \ . • '[u' , .. '.•'.'^ ' "* V. v '/^^.^^^vi^^^'' 

V ■ - - 10 > • ■ - • • ... , . .. •> .:-r<- . • ' 

</Dyhamics> ' . ■ ■ 'r' ■ ' 

_ </Xmi.pataSource> ■ - ' ' . : . ■ 

Figure 20 - Sample Dynamics Definition 

Within the CDATA section is defined all the dynamics execution scripts. Each script function 
represents a specific dynamics definition to be used within the display. In the example above, the 
SWiTCHO function represents a Switch logic with test condition. The CDATA wrapper is used to tell 
the consumer of this XAML file that the content contains custom data and should be treated *as Is" 
and not as XML. 
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2.5.4.4 Dynamics Instances 



A Dynamics Instance pertains to a specific application instance of a certain dynamics definition within 
the display In relation to actual Input and output parameters. This means that within a display XAML, 
there could be zero or more than one dynamics instances specified. Each dynamics instance is 
defined using the MSAvalon XmlDataSource object tag with the def:Name prefixed with the word 
'DYN^INST^*. The following shows the structure of a dynamics Instance: 

<XmipataS6urce "DYN_inst_MYDYNINST" XPath="Dynamicslnstance"> " ^ 

<Dynaniics.Instance xmTns-"" £unc»'*MYFUNCTION (INNAME, INNAME_N, 0, -. -- 1)"> 

'<6ut name«"OUTNAME" source="SOURCE" path«"PATH- value="VALUE" -/> . ^ 
... <ln name="INNAME" sourcee"SOURCE" path="PATH" /> 

<In -naine-="INNJ\ME_N" source="SOORCE- path="PATH"; /> / .V: \ 

' </pynamic'sInstance> " ; . . i -^•:^i->\: :-^ ■ 

. </XniJ!Dat:aSource> ' . •. , • ^ . :•■ 'j- ^ / % 



Figure 21 — Dynamics Instance Structure 



The func attribute Is where the function signature of the dynamics definition to be used is specified. A 
function parameter could be a constant or a reference to an input (In) parameter. 

Under the Dynamicslnstance XML node, one Out parameter and zero to more than one In parameters 
can be specified. An Out parameter represents the object or link to which the result of executing the 
associated dynamics definition is assigned, and In parameter represents the object or link from which 
a parameter should get input data from. Both In and Out parameters contains the following attributes: 

• name Name or alias of the parameter. For both In and Out parameters, this Is used to 

replace the references listed in the function signature with the current value of the 
object or link. 

• source Source of the parameter. Each source, e.g. 'DiSPLAy for display objects 'RT 

for DeltaV runtime datalinks, "HISTORY* for history objects, etc. must be defined. 

• path Path of the parameter. If the source is "DISPLAY*, path should take the form of 

"[uieiementjdj.fpropertyr. For example, "Linel.Xr pertains to the XI property of 
the Ul element from the Display section with id "Line1". 

The Out parameter has an extra attribute called value, where the Initial value of the output parameter 
is specifted. This is required since the XML node attribute is bound dynamically to the Ul element 
associated with the Out parameter. This way. the container may update this node attribute to change 
an Ul element's property without going through a manual search for that element within the graphics 
object model by name. 
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2.5.4.5 Event Dynamics 



An Event Dynamics pertains to a specific event application instance of a certain dynamics definition 
within the display in relation to actual input and output parameters. This means that within a display 
XAML, there could be zero or more than one dynamics instances specified. It is very similar to 
Dynamics Instances, except that the associated dynamics definition is executed when a particular 
event is triggered, and the def.Name is prefixed with the word *'EVENT_'*. The following shows the 
structure of an event dynamics: 



<XmlDataSburce " EVENT JMYEVENT" XPath«"DynainicsInstance"> 

<Event Dynamics xinlns=-" func^-MYFUNC (INNAME, INNAME_N) event ="OBJID.. EVENT ••> 

<Out naine="OUTNAME" source^" SOURCE" pat h=" PATH" vaIue="VAL"UE". /> 
. . <In naine«"INNAME" source*" SOURCE" path-"PATH" /> 



, . <ln naine="INNAME_N" source^" SOURCE", pat h^" PATH" /> 
</ Event Dynamics > 
r</XmiOataSource> . . 



Figure 22 - Event Dynamics Structure 



The addition to the structure of the event dynamics in comparison to the dynamics instance is the 
event attribute, which specifies the control object and the name of its event to linic the dynamics to. In 
the example above, to link EVENT_MYEVENT to the Cllcic event of the Button with Id^'MyButtorf, 
assign "MyButton.ClicIC to the attribute. 
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2.5.5 Process Graphics Runtime User Interface 

The Process Graphics Runtime application Is implemented as an MSAvalon Navigation Application 
that consists of a main window and multiple floating child windows. Each window is capable of 
processing a Process Graphics Runtime XAML file, displaying the graphics objects, and running the 
dynamics behavior defined. 

The main window is an MSAvalon NavigatlonWIndow consisting of a window container that hosts 
Process Graphics Runtime display XAMLs. 



2.5.5.1 Loading Displays 

The first and most basic feature is the loading of display XAML files and the dynamics defined therein. 
The following diagram shows the object collaboration supporting loading: 



Extract Dynamic 



5 : ne««0ynln8t | 
*new( dynlnstSouice. Document ChihfNodest'DynafniCftlnstanceV; 




*Add( dynbistSourcB.Name. newOyALp^ 



*Aa4( name. nsi«OynInstln 



3 : dynDelSoutce : 
vtRei 



GvtResource( 'DynamicsDef ) 

4 : dynlnslSource :« 
*GeiRasource( •DVNJNST^- ) 



SetScnpt( dyft08fSouree.Documdntlnn8rTaxt ) 



Figure 23 - Object Collaboration Diagram for Loading a Display 



Upon loading a display XAML file, the container window processes the dynamics sections and creates 
the appropriate objects to represent them. Out parameters of Dynamics Instances are dynamically 
bound to the specific Ul element's properties, while the generic event handler function of the window 
is set to listen to the events of the control objects specified in Event Dynamics. 

The created dynamics objects are then saved into a hash table, which will be processed one by one 
within a dynamics timer thread. The script In the dynamics definition section is set In a script executor 
(ScrlptExec) for later use. Once everything's processed, the dynamics timer is started. Currently one 
dynamics timer is supported within the container window. 
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2.5.5.2 Dynamics Processing 

The container window utilizes a timer object to process the dynamics specified In the Dynamics 
instance sections at a given time interval (default 100ms). During each interval, each dynamics 
instance is processed by creating the right function signature with the appropriate parameter values 
from the specified parameter sources. The resulting signature is then sent to the script executor 
(ScriptExec) for execution. The ScriptExec dynamically compiles all the scripts if it hasn't done so 
before actually executing the scripts. The result of the execution is then set to the appropriate Out 
parameter. 



f : dynlnsttn 
*GetD]rnin8tlnO 



EKecute( params ) 




5 : script 

Gen8ra!8Scri|n( params ) 



6 : outElement.VdIua :») 
EMecuteFunc( 8Cii|M ) 4 




3: 

*Add( dynlnstlrtName. paramVali^ 



2.b : paramVidiid i** 
*GetVatue< dyn|fi6ttn.Path ) 



I 2.a.2 : paramValue :« 
kGotValue( dp) 



2,a : target := 

k*FmdLogicaINode( wNavContainerConterji. dynlnstin.Eloment ) 



2.0.1 :dp :« ■ 

FromNamo( dyntnslln.f roperty, tatQet.GetTypeO ) 

I 



i{((dy nf nsi 1 n, Spurc'e^^ 



•OiSPLAY" 




Figure 24- Objece Collaboration Diagram for Dynamics Processing 



2.5.5.3 Event Handling 

The event handling dynamics process is actually very similar to the processing of Dynamics 
Instances, except for the fact these dynamics are executed when the associated event is triggered. 
Once triggered, the generic event handler will go thru the same process discussed in the previous 
section. 
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3 Process Modules 



3.1 Objectives 

The objectives for Process Modules are: 

1- Abnormal Situation Prevention - Users will be able to use Process Module algorithms to 
determine abnormal conditions that would otherwise be difficult to detect. 

2- Integrated - Process Modules are fully integrated with operator displays, alarms & events, 
configuration, runtime, historian and other subsystems. 

3- Ease of use - Process Modules will be easy to use. Process Graphic Displays will be able to 
reference values in Process Modules with very little additional configuration effort. During runtime 
the Process Module results can be completely hidden or turned on in layers depending on the 
capabilities of the users and their option settings. 

4- Best engineering practices — The system will be designed to facilitate re-use of processing 
elements, graphics, and simulations thus minimizing configuration and testing effort. 

5- Separation of the process graphics from the process module engine. The runtime 
environment for Process Modules will be separate from the engineering and display environment. 
This is important so that Process Modules can at some point be made redundant, support on-line 
upgrades, can be easily moved around the system taking advantage of computing resources, etc 

6- Flexible data bindings — Process Modules can retrieve data from multiple data sources 
including Runtime, Historian, OPC, Services, XML Files, etc. 

7- Secure - Process Modules need to participate in the same session and authentication 
infrastructure as the rest of DeltaV. 

8- Smart Objects - Process Modules are the algorithms behind Smart Objects technology. 

9- DeltaV Look/Feel - Editors and runtime have the same look/feel as the rest of DeltaV. 
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3.2 Overview 



Operator graphics often depict the devices, equipment and connections between them. The arrangement 
drawn closely resembles the physical connections in the actual plant. If the devices and equipment on 
these operator displays were created from Graphical Process Elements representing physical equipment 
and Process Streams representing physical pipes etc^, then it would be possible to infer additional 
relationships such as flows, mass balances, etc. The relationships defined in these graphical displays will 
be stored in the process database^®. The following is an example of a Process Graphic derived from the 
P&ID of a plant. 




Figure 25. Process Graphic 



In the above graphic the Process Element Tank' will be aware that it has links to flow transmitters on 
either end. The awareness is captured in the properties, connectors, algorithm, and rules associated with 
the Tank graphic. 

The underlying process database is updated when the process graphic display Is updated and as a result 
it's business rules are modified. The rules are encapsulated in the process algorithm which has access to 
the process flow database and to process values from the plant.^^ 

In this example the business rules will cause the tank object to interact with the linked transmitter objects 
and generate an alarm if it detects that its level is changing when it should not. This may be indicative of 
a possible leak in the tank, which should be repaired. 



Traditional operator interface do not automatically embody the logical relationship between these objects; instead 
each object is shown as an independent entity, and the logical relationships are in the mind of the operator or are 
embodied thru specially developed logic. 

Part of Configuration Database 

The process flow database and rules engine will be co-located. The same process elements and links can be 
shown on multiple displays. 
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Blend storage 900 



Figure 26. Process Graphic - Advisory Alarms 



Using these capabilities it is possible to do the following: 

o Abnormal situations are detected and notifications issued. 

o Mass balances are calculated for equipment. 

o Loss tracking is possible with little or no configuration. 

o The interconnection and the logical interaction between equipment provide a higher level of 
diagnostics for the plant. 



In a control system the operator is faced with managing large process areas. Each process area may 
have hundreds of measurements that indicate the process operating conditions. Thus, it is not possible 
for the operator to constantly monitor all process measurements. As a support for the operator, process 
control systems have supported process alarming based on these measurements to alert the operator of 
an abnormal processing condition. Such alarms may be based on the absolute value of a measurement 
or on the deviation of a process parameter from setpoint. However, since a process may be required to 
run over a wide variety of operating conditions, process alarm limits may detect extreme cases of sudden, 
complete failure. 

Finding an effective means of providing early detection of measurement or process failure has been a key 
area of research in academia and industry over last 20 years. Much progress has been made in the 
application of multivariate statistical process control. MSPC. for detecting and isolating process and 
measurement faults. By leveraging off of the results of this research, an easy to use MSPC capability 
may be embedded in the DeltaV control system. DeltaV customers can use the MSPC capability to 
improve plant performance by reducing loss production and off-spec. Thus, multivariate analysis based 
on MSPC capability can differentiate DeltaV from other control systems that do not have this capability. . 

Each of these capabilities is supported by standard framework called Process Modules. Each specific 
application requires an algorithm type. The algorithm types that will be discussed in this document are: 

1- Process Simulation 

2- Expert 

3- MSPC 

4- Other (e.g. Mass balance. Optimization) 
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3.2.1 Process Simulation 

The implementation of process simulation Is an important part of the Starburn project. Many of the basic 
concepts associated with the creation of simulation based on the operator graphic display were disclosed 
In the Starburn concept document. The information below presents an introductory background. Full 
details are provided in the Process Simulation Concept Document. 

3.2.1 .1 Processing Elements 

A set of predefined graphic elements will be provided for the construction of Process Graphics and 
Process Modules. These graphic elements will be designed to dynamically show on-line measurements 
and actuators that interface to the DeltaV control system. Unmeasured parameters that reflect process 
operation will be calculated using on-line process simulation * these calculated parameters will be shown 
as an integral part of the associated graphic elements. 

In an offline environment used for engineering or training environment, the graphic elements will 
automatically show measurement values based on process simulation. The values calculated by process 
modules are based on the actuator position or state as well as manual disturbance values. Process 
modules can be created from the graphic elements used to construct Operator Process Graphic Displays. 

3.2.1 .2 Process Connections 

In many processing plants, the step associated with manufacturing may involve handling solid materials, 
liquid and vapor, and gases. To cleariy illustrate the material flow through the process, three different 
types of process connections will be support. 

• Piping - for liquid and high pressure vapor or gas flow 

• Duct - for low pressure gas flow 

• Conveyor - for the movement of solid material between processing units. 

The properties of the material that is transferred by connections are determined by the upstream input. 
This information plus the connection status are available as properties of the connection. The elements 
that may provide this upstream input are the following: 

• Processing element Output 

• Actuator element Output 

• Stream element Output 

The properties of a connection will be displayed when the cursor is placed over the connection. Also, the 
properties associated with a connection may be exposed for permanent display by placing a 
measurement or estimated property element on the connection. 

A connection element may terminate at one of the following elements; 

• Processing element input 

• Actuator element input 

• Stream element input 

3.2.1 .3 Process Actuators 

Actuators may be placed between process connects or between processing elements and a connection. 
In some cases an actuator may be used with a specific connection type i.e. pipe, duct or conveyor, as 
defined below: 



Pipe Duct Conveyor | 
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Regulating valve 


X 






On-Off Valve 


X 






Pump 
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Eductor 
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Force Draft Fan 
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Damper Drive 




X 




Feeder 


X 




X 


Motor Drive 






X 



3.2.1.4 Measurements and Property Elements 

The transmitter element is used in the display to access the measurement value associated with a 
physical transmitter or switch. This element can be added to a connection element or to a processing 
element. When a transmitter element is added to the display, the user must identify the associated Al, 
PCI or Dl block in DeltaV. In the on-line mode, the value of the measurement will be shown next to this 
measurement element. In the off-line mode the simulated value of the measurement will be automatically 
displayed based on the value calculated by the associated process simulation module. 

An estimated property element may be added to a connection or processing element to display any 
property of that element. When this element is placed on a connection or on a piece of equipment then 
the user can browse and select the properties that will be displayed. Thus, properties that are not 
available through a physical measurement may be exposed through the use of the estimated properties 
element. 

3.2.1.5 Processing Elements 

Plant equipment other than measurements and actuator and connection will be represented in the 
operator display as processing elements. All inputs and outputs to a processing elements will be made 
through connection elements. 

Standard processing eiements will be provided for the following plant equipment: 

• Tank - vertical 

• Tanks - horizontal 

• Heater 

• Static Mixer 

• Reactor 

• Mixer 

• Air Heater 



For these standard processing elements, the user may specify the number of inputs and outputs to and 
physical equipment properties e.g. size. The simulation algorithm and static representation of these 
standard processing elements may not be modified by the user. 
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All other plant equipment will be Implemented as Custom Processing Elements. The static 
representation, number of inputs and outputs and the simulation algorithm may be modifled to meet the 
user interface requirements. Once a custom processing element has been defined, it may be saved as a 
temptate that may be reused or used as a starting point in the creation of other processing elements. 

Custom Processing Elements such as distillation columns, evaporators, separators, bolter etc many be 
described using a step response model relating each input to each output of the vessel. Inputs may be 
gas and/or liquid streams. Optionally, the user may define the equations that describe the relationships 
between the inputs and outputs of the processing element. 

3.2.1.6 Process Graphic Streams 

Stream elements may be included in a display to define the starting properties associated with a 
connection element. Also, stream elements may be used as connection points between displays. For 
such off-sheet connections between displays, the user may click on the stream to immediately call up the 
associated display that contains the referenced connection. 

3.2.1.6.1 Mass / Composition 

The mass/composition stream element will normally be used for define the 
starting properties of a process input i.e. the starting feedstock 
composition, etc. or to define a link to a stream connection on another 
display. Connections may be made on the input or output of the 
mass/composition steam element (not both) 

The following must be configured for this element: 

• Name of the stream (unique within the DeltaV System) 

• Properties of the steam (if no reference input of input connection) 

o Mass fraction of component (if more than one) 

o Pressure or mass flow 

o Temperature 

o Specific heat 

o Density 

o Connection type (pipe, duct, conveyor) 

• Referenced Input Stream( if used of accessing a stream on another display) 



3.2.1.6.2 Energy 

The energy stream element will normally be used for define the starting 
energy associated with a process input i.e. the BTU/HR transfer, etc. or to 
define a link to the energy properties of stream connection on another 
display. Connections may be made on the input or output of the energy 
stream element (not both). 

The following must be configured for this element: 

• Name of the stream (unique within the DeltaV System) 

• Properties of the steam (if no reference input of input connection) 

o Energy flow 

o Connection type (pipe, duct, conveyor) 
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Referenced Input Stream( if used of accessing a stream on another display) 



3.2.1 .7 Example - Fluid and Gas Flow Simulation 

In Fluid and Gas Flow Simulation pressure is the driving force for liquids or gas transfer between vessels. 
The flow through a transfer pipe or duct is based on the starting pressure and the pressure drops 
introduced by the processing elements in the flow path e.g. pipe, valves and the point of discharge. To 
illustrate this three typical examples that will be encountered in a process simulation are presented below. 

Specified Starting Pressure - In some cases, the upstream equipment may not be included in the 
simulation and the user must specify the starting pressure as part of the stream properties - pressure is 
defined as the independent parameter. When stream pressure (starting pressure) is specified, then the 
flow through the associated pipe is determined by the pressure drop introduced by the pipe and the 
elements in the pipe and the pressure at the point of discharge into a tank, as illustrated below. 




Starting 
Pressure 



Regulating 

Valve 

Drop 



Blocking 
Valve 
Drop 



Pipe 
drop 



Tank 
Pressure 



System Pressure Drop 



Figure 27. Fluid and Gas Flow iSimulation - Specified Staring Pressure 



Vessel Establishes Starting Pressure - If a vessel is pressurized, then this pressure may be used as 
the driving force for transfer of vapor to liquids between tanks or from a tank to a vent, header, etc. 
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Figure 28. Fluid and Gas Flow Simulation - Vessel Establishes Starting Pressure 
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For this example, the driving force for steam flow is the differential pressure between the high and tow 
steam header. Since the pressure in each header, then the differential pressure is variable. The pipe 
flow thus is determined by this differential pressure, the position of the regulating and on-off valve, and 
line loss. This relationship is similar to that previously illustrated for the case where the starting pressure 
was specified. 

Pump or Fan Establishes Starting Pressure - A pump or fan is often the pressure source that provides 
the driving force for liquid or gas flow respectively. In such cases, the pressure provided will be a function 
of the flow. This relationship may be documented by the equipment manufacturer by a pump or fan curve 
that shows the expected pump differential pressure as a function of pump flow. The following variable 
speed pump example may be used to illustrate the impact of pump discharge pressure with flow rate. In 
this example, the liquid supply to the pump is assumed to be from a tank at constant (atmospheric) 
pressure. In this example, pump discharge flow travels through a pipe to a heat exchanger before 
entering another tank (at atmospheric pressure) as illustrated below. 




Tank 



Figure 29. Fluid and Gas Flow Simulation - Pump or Fan Establishes Starting Pressure 



3.2.2 Expert 
3.2.2.1 Background 

Conventional programming languages, such as C#. are designed and optimized for the procedural 
manipulation of data (such as numbers and arrays). Humans, however, often solve complex problems 
using very abstract, symbolic approaches which are not well suited for implementation in conventional 
languages. Although abstract information can be modeled in conventional programming languages, 
considerable programming effort is required to transform the information to a usable format. 

One of the results of research In the area of artificial intelligence has been the development of techniques 
which allow the modeling of information at higher levels of abstraction. These techniques are embodied 
In languages or tools which allow programs to be built that closely resemble human logic in their 
implementation and are therefore easier to develop and maintain. These programs, which emulate 
human expertise in well defined problem domains, are called expert systems. The availability of expert 
system tools, such as CLIPS, has greatly reduced the effort and cost involved in developing an expert 
system. 

What is CUPS? 

C Language Integrated Production System (CUPS) is an expert system tool which provides a 
complete environment for the construction of rule and/or object based expert systems. Created in 
1985 at the Johnson Space Center, CUPS is now widely used throughout the government, 
industry, and academia. 
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Rule-based programming is one of the most commonly used techniques for developing expert systems. 
In this programming paradigm, rules are used to represent heuristics, or "rules of thumb." which specify a 
set of actions to be performed for a given situation. A rule is composed of an //portion and a then portion 
The //portion of a rule is a series of patterns which specify the facts (or data) which cause the rule to be 
applicable. The process of matching facts to patterns is called pattern matching. The expert system tool 
provides a mechanism, called the inference engine, which automatically matches facts against patterns 
and determines which rules are applicable. The //portion of a rule can actually be thought of as the 
whenever portion of a rule since pattern matching always occurs whenever changes are made to facts. 
The then portion of a rule Is the set of actions to be executed when the rule is applicable. The actions of 
applicable rules are executed when the inference engine is instructed to begin execution. The inference 
engine selects a rule and then the actions of the selected rule are executed (which may affect the list of 
applicable rules by adding or removing facts). The inference engine then selects another rule and 
executes Its actions. This process continues until no applicable rules remain. 



3.2.2.2 DeltaV Expert 

DeltaV Expert is an expert system application for process control. It utilizes CLIPS as Its core inference 
engine. This is illustrated in the diagram below: 
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Figure 30 - DeltaV Expert Overview 



The idea is to use expert system technology to assist the operator in the detection and management of 
abnormal situations in a plant. Through the early detection of abnormal conditions using expert systems, 
it Is possible to improve plant operation or to prevent a failure that could cause a process shutdown. 
Also, during shutdown and startup conditions, expert systems can be used to draw the operator to 
abnormal situations that might affect plant operation. 

Some or the areas of abnormal situation management that an expert system can effectively address are 
the following: 

• Alarm screening - presentation of the root source of an alarm condition so that the operator is not 
distracted from the critical events that are associated with and equipment feilure. 
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• Detection of process change - Degradation of equipment performance because of improper 
equipment setup and wear or buildup in pipes and heat-transfer surfaces may alter the behavior 
of equipment. The automatic detection of significant process changes helps prevent equipment 
damage and associated production loss. 

• Detection of abnormal conditions - The automatic detection of patterns in plant operation that 
indicate an abnormal condition may bring this information to an operator's attention sooner that 
process alarms. 



3.2.2.3 Integration with DeitaV 

Integration of Expert with configuration and runtime infrastructure allows users to configure, document, 
and then to download an expert system subsystem running on a ProfesslonalPlus or Application Station 
node. Standard fact templates will be provided to allow consistent and easy access to real time data, 
historical data, event chronicle data, and historical data. To make it easy for a customer to begin using 
and getting benefit from the expert system capability, predefined expert rules will be provided. The option 
is provided for an expert to define their own facts and rules to address the unique situation of a particular 
plant. In addition, DeltaV Expert allows you to examine the execution of the rules application. Fact data 
that is based on process measurements may be examined as the application executes and. if simulation 
is enabled, values provided for testing the expert rule evaluation. Also, using the toots provided by 
OeltaV Expert, it will be possible to place break points in rule evaluation and to examine the state of rule 
evaluation. This document will be used in developing the use cases for the off-line (configuration) and the 
on-line (run time) interaction with the rule evaluation and the operator interface support. 



3.2.3 MSPC and PCA 

Within the discrete parts manufacturing segment of industry, univariate statistical methods, SPC, have 
been successfully applied to detect deviation of the process from normal conditions. However, in the 
process industry, such techniques do not generally apply since most process measurements usually 
demonstrate a strong correlation under normal conditions. However, many researchers have realized 
that these measurement correlations provide a necessary redundancy to detect, identify and reconstruct 
a faulty sensor. Two statistical projection techniques have been developed to address the requirements 
in the process industry; Principal Component Analysis (PCA) (Jackson. 1991) and Partial Least Squares 
(PLS) (Geladi and KowalskI, 1986). Most of the commercial products for multivariate on the market today 
have their roots in these techniques. 

Two statistics are commonly used in conjunction with IV1PSC in fault analysis: 

■ Square Prediction Error Q - a measure of lack of model fit 

• Hotelling's T^ - a measure of the variation within the PCA model 

MSPC could be structured as an integral part of DeltaV. By embedding MSPC as a feature of the 
Process Modules, then the configuration effort could be greatly reduced. 

■ The engineer could define and generate MSPC firom the operator screen 

■ Correlated parameters were automatically known from the process connections on the operator 
graphic. 

The engineer could elect for all correlated parameters in the module to be automatically included in the 
PCA or the user could elect to include a portion of the equipment rn the analysis. In response his request, 
a historic plot of these parameters would be displayed and the engineer could select the time frame to be 
considered in generation of the PCA. The PCA would then be automatically generated. 
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Once the PCA is created, then the pattern of square prediction error can be used to detect a faulty 
sensor. The faulty sensor can be automatically highlighted in the graphic measurement element on the 
operator screen - no extra configuration required since the PCA is part of the module and the 
measurements are defined by the graphic configuration. An instance of an expert kemel could be 
included with the PCA as part of the process module. The expert kemel could be used to analyze the 
alarms associated with the measurements associated with the process module. 

From the process connections, the cause and effect could be automatically determined in process 
alarming. 

Automatically screen operator alarms other than that associated with the root problem. Module options 
would be provided to allow smart alarm screening to be enabled or disabled. Default rules used by the 
expert kernel would automatically be provided to analyze the square prediction error (SPE) associated 
with the module PCA to detect abnormal processing conditions. The Facts used in these rules would 
define the range of the SPE for a specific condition. The Facts range value could be established by the 
engineer viewing the historian data for the parameters in the module PCA. When engineer Identifies the 
time of that an abnormal condition existed, then the SPE value will be automatically saved as the Fact 
range values for the identified condition. The Fact range values could be established by an operator 
when he identifies an abnormal condition has occurred during normal operation. 

When the expert kernel detects a pattern that matches the facts, then the operator would be notified of 
the abnormal condition being detected. 
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The interaction of the PCA. expert kernel with the process module Is illustrated below. 
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Figure 31. Interaction of the PCA» Expert kernel with Process Modules 



3.2.4 Other Algorithms 

Other algorithms under consideration are for Route Management, Mass Balance, and Optimization. 
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3.3 Key Requirements 

3.3.1 Process and Processing Elements 

1- Must be tagged (tagging means that they can be referenced by the runtime). 

2- Are associated with physical items in the plant - e.g. tanks, pumps, etc. 

3- Consist of parameters, connection points and behavior. 

4- Parameters can be simple parameters or smart parameters. Smart parameters can be 
interpreted and used by the process flow rules engine. 

5- Connection points represent points at which an object can be attached to other objects by means 
of pipes or other link mechanisms. A connector is tied to an object parameter. 

6- Contain Mode. Status, and Alarms. 

7- Behavior can is coded in a language such as C#. 

8- Can also have rules associated with them. 

9- Are arranged in Class Libraries (e.g. a pump). 

10- Can be collected together into a composite structure. The composite structure would be a Class 
Based item In the Class-based hierarchy. 

11- Behavior is executed by "Display Module Execution Engine". 

12- Rules are executed by a separate rules engine. 

3.3.2 Streams 

13- Must be tagged. 

14- They are a representation of physical pipes and other link mechanisms. 

1 5- Are used to represent process flow between "smarT process objects 

16- Contain special properties that define how different "things" flow through the smart links (e.g. 
steam, electricity, water, sewage, etc.). 

17- Ensure that Engineering Units of the source and destination object connectors match. In the 
runtime they also provide opaque data conversions. 

18- Can be debugged. 

3.3.3 Process Algorithms 

19- Have special properties including. Mode, Status, and Alarm Behavior. 

20- Can be assigned to workstations. 

21- Are downloaded as part of display downloads. 

22- Can simultaneously execute one or more process flow algorithms types: Mass Balance, Routing, 
Efficiency, Optimization. Economic Calculations, other. 
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23- Can read parameters from DeltaV Control Modules. 

24- Can expose parameters for access by other DeltaV Control Modules. 

25- Can control the execution of process flow algorithms. Execution can be enabled and disabled. 

26- Are verified before download in the process flow database. 

27- Can be acquired and released. 

3.3.4 Process Modules 

28- Have runtime execution. 
29' Alarming 

3.3.5 Documentation 

30- Process Elements represented in the Process Graphics may also provide hot links to key 
documentation. 

31- The documentation may be applicable to the type of object, or may be specific to the instance 
(depending on the criticality) of the device. 

32- The documentation may be vendor supplied. 

33- The documentation may be user supplied. 

34- The user will be able to add/delete/change documentation independent of the system software. 

35- Documentation may include configuration, operational and maintenance categories. 

36- Clicking on the object brings up the instance specific (if any) and generic documentation. 

3.3.6 Expert 

37- . 

3.3.7 MSPCandPCA 

38- . 

3.3.8 Other 

39- . 
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3.3.9 Documentation 



40- Process Elements represented in the Process Graphics may also provide hot links to key 
documentation. 



3.4 Process Module Architecture 

3.4.1 Overview 

3.4.2 Configuration 

3.4.2.1 Overview 

The... 
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3.4.2.2 Simulation 



3.4.2.2.1 Generation of Process Modules from Process Graphic Displays 

The configuration environment for Process Graphics and Process Modules will be integrated with the 
existing configuration environment to ensure that configuration is entered once^®. Display configuration 
includes operator displays, dedicated displays for batch and advanced control, dedicated displays for 
alarm and alert management, dedicated displays for route management, etc. The Process Graphic 
Display configuration environment is illustrated in the figure below. 
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Figure 32. Configuration Environment 

At the Process Graphic level we have a view that is very similar to what is available with iFIX today. At 
this level the user selects Process Graphic elements such as Valve, Pump. Tank, Heater, Mixer, etc 
drops them on a Process Graphic and then connects them together using piping. The user adds 
animations, dynamic values, etc to control, measurements or actuators as they would with iFIX. 

At configuration time users can select Process Graphic Displays and generate process simulation. The 
dynamic simulation will be constructed from simulation function blocks that are based on simple 
composition calculations, mass balance, energy balance and custom calculations. 

If high fidelity process simulation is required, then a simulation package such as HYSYS may be linked 
into DeltaV through process modules. In this manner, information from the process simulation may be 
made available on the Process Graphic Display. 

A Process Module may be generated from a process graphics. The functionality available to the Process 
Module is determined by the Process Graphic elements. What should be clear is that the Process 
Module will be constructed to shadow the Process Graphic Display. 



The basis for the integrated environment was covered in the Common Control Language Patent which issued in 
1997. What wasn't thought of at that time was using the integrated environment as discussed here to embed 
functionality. 
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When the user configures their Process Graphic Display they have the ability to include additional 
information such as Mass or Energy Streams. These streams are used in the process module to 
establish starting conditions needed by the simulation function blocks. 

Since Process Modules are real DeltaV Modules, it is also possible for them to reference, and be 
referenced by, DeltaV parameters, control strategies, displays, etc as Illustrated below. Also, using this 
capability, it is possible for a process module to be created in DeltaV Control Studio independent of the 
Process Graphic Display. 

3.4.2.2.2 Process Modules and Process Displays for Off-line Simulation 

The process simulation may be designed to include hand valves and local panel inputs that will exist in 
the plant but are not wired into DeltaV. Traditional operator training systems (OTS) have included custom 
built instructor graphic displays that can be included graphic displays to represent and provide access to 
these local components. To avoid the need for separate instructor displays, the operator graphic will be 
designed to support layers of Information that may be visible or not visible depending on the user and 
whether the display is being used for off-line simulation or on-line operation. In particular, it will be 
possible for the user to add an instructor layer to any operator graphic. Through this instructor layer, it 
will be possible to add manual valves and other graphic elements that represent and provide access to 
the simulation of local valves, local panel input, and disturbance inputs to the process simulation. 

In the graphic display editor, a number of display pallets to support the creation of graphic displays. The 
following standard palettes provided in DeltaV: 

• Calculation and Control - elements to access information from function blocks used in control and 
calculation e.g. PID function block SP. PV. OUT 

• Properties and Measurement- elements used to access or specify field measurements and 
simulated properties associated with connections or process equipment i.e. field measurement, 
simulated values. 

• Actuators - elements representing field devices used to set or regulate process streams 

• Processing - elements representing common process equipment. 

• Custom - elements that allow equipment that is specific to a manufacturing process to be 
represented in the graphic display. 

As in Control Studio, the user may create his own palette from items included in these standard 
palettes. All the elements included in the display except for Steam and Connection elements may be 
modified by the end user to satisfy his display requirement. 



3.4.2.3 Expert 

3.4.2.4 MSPC and PGA 

3.4.2.5 Other 
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The control environment for Control and Process Modules will allow access to parameters, alarms, etc. 
This integrated environment control environment is illustrated in the figure below. 




Figure 33. Integrated Control Environment 
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3.4.3.3 Expert 

3.4.3.4 MSPC and PCA 

3.4.3.5 Other 

3.4.4 Operator Displays and Alarming 

3.4.4.1 General 

3.4.4.2 Simulation 

3.4.4.3 Expert 

3.4.4.4 MSPC and PCA 

3.4.4.5 Other 

3.4.5 Diagnostics 

3.4.5.1 General 

3.4.5.2 Simulation 

3.4.5.3 Expert 

3.4.5.4 MSPC and PCA 

3.4.5.5 Other 
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4 Runtime Workspace 



4.1 Overview 

The runtime workspace provides a completely integrated environment for operators. Although the 
primary applications are Process Graphics and Alarm Management, the workspace must also host other 
applications such as trending, batch, and advanced control. It is becoming common to also host other 
applications such as streaming video. 

4.2 Objectives 

The runtime workspace and integrated applications are the main operator interface for the DeitaV 
System. The primary objectives for the runtime workspace are: 



1. Highly reliable application intended for process control operators who need to stay in control of 
the manufacturing process in all circumstances. Characteristics include: 

• Always available. In many cases, the application must be available for long periods of time 
(e.g. weeks, months, even years) without unplanned disruptions. 

• Always interacting. Operator must always have the opportunity to "move on"; getting 
predictable responses to new directives even when previous requests take "too long" to 
complete, or "everything is changing" due to a plant upset. 

• Mistake resistant. Repeatable behaviors and user interaction features that can help reduce 
the possibility of high cost "human errors"; especially in high stress situations. 

2. Extremely responsive interactions and high performance display of process information. 
Expectations for large user configured displays to appear and be populated with live data from 
the DeltaV system typically within 1 second. (Smaller displays like our pre-engineered "faceplate" 
style displays correspondingly faster.) 

3. Supports a dedicated (kiosk style) operator environment, which is extremely resistant to users 
damaging the programs or data present on that workstation, or gaining access to unintended 
applications. The degree of restriction is user configurable, so that the workspace is also suitable 
for use by trusted and higher skill level users. 

4. Adaptable to a wide range of user interface hardware features: 

• 1- 2- 3- or 4- monitor video configurations 

• 4:3(PC format) and 1 6:9(HDTV format) aspect ratio monitors 

• mouse + keyboard operation 

• touch screen operation 

• PDA form factors and user input techniques 

• Tablet PC form factors and user input techniques 

• Smart Phone form factors and user input techniques 

5. Excellent integration of operator tools/applications (e.g. Batch. Advanced Control. Diagnostics, 
History viewing) with user configurable displays (and user display logic). Easy access to 
information related to display elements. Easy access to auxiliary information sources (e.g. video 
feeds) and colFaboration technologies (e.g. e-mail and instant messaging.) 

6. Operator-fn'endly tools to select and manage the content in the runtime workspace; minimizing 
window management responsibilities. Improved features for rendering content within the 
available space, so that a content sources not specifically engineered for the workspace are 
easily usable. 
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7. Well integrated user security and authentication facilities to support: 

• Fast DeltaV user switching (comparable to pre-Starburn systems) 

• DeltaV user collaboration (temporarily aggregating security privileges) 

• Multi-user authentication for electronic signature requirements 

• Authentication technologies that do not require passwords 

• Login timeouts 

8. Platform for improved information capture and analysis tools for operations staff. Features like: 

• Snapshot log: recording information for later examination 

• Tools for finding revealing alarms in an alarm flood 

• "Back in time" displays: ability to look at displays based on (automatically collected, recent) 
historical data 



4.3 Workspace Desktop Management 

The runtime workspace application(s) will operate in either of the following desktop management modes: 

• The "Dedicated and Controlled" desktop 

• As Just "Another Windows Application" 

4.3.1 Dedicated and Controlled Desktop 

The "dedicated and controlled" desktop management mode allows DeltaV system administrators to 
deploy the runtime workspace so that its users do not inadvertently (or maliciously) damage the 
software/data installed on that (serving) workstation, nor cause the runtime workspace to be inoperative. 

4.3.1 .1 User needs 

a) It is possible to configure a workstation (or session on a server) to automatically start after system 
boot-up in "dedicated and controlled" desktop management mode. In this mode, one instance of 
the runtime workspace is allowed to run in each workstation (session). 

b) A "workspace hard reset" mechanism is required, which causes the run-time workspace to revert 
to the initial startup condition (framework contents) without requiring it to be shut down and 
manually restarted. This is intended as the last resort available to operators to restore an 
(apparently) malfunctioning runtime workspace to working condition (short of rebooting the 
workstation/sender). It is acceptable for a "workspace hard reset" to take up to 30 seconds^. 

During the reset, a message should be provided indicating that a reset is in progress, along with 
some updating indication that the screen hasn*t frozen. 

c) Certain users should not be constrained to the "dedicated and controlled" desktop management 
mode. Users with appropriate DeltaV security keys, can switch to "another Windows application" 
desktop management mode (retaining as much current workspace context (panel contents, 
recently used history, etc.) as possible. 

d) While in "dedicated and controlled" desktop management mode, users are prevented from 
running unintended programs or applications. This requires: 

• Disabling access to the Start dialog (Windows key and Ctrl-Esc) 

• Disabling access to the Windows taskbar 

• Disabling access to Windows keyboard shortcuts; especially including: 

a. Run dialog (WinKey R) 



The intent that this would be a "deep" enough reset to con^letely clean up and reinitialize the runtime workspace 
and all runtime workspace con^anion applications. 
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b. Minimize all (WinKey + M) 

c. Switch to another (non-runtime workspace) application (Alt-tab) 

d. OS Explorer (WinKey + E) 
e. 

• Not allowing access to Windows desktop shortcuts 

e) The runtime workspace will allow specific (non-runtime workspace) applications that have been 
authorized (via DeitaV confi^ration). The user will be presented a list of applications (and 
descriptions) to choose fronr^. 

f) While in "dedicated and controlled" desktop management mode, users are prevented from 
making the runtime workspace inoperative. This requires: 

• Not allowing the termination of the (primary) runtime workspace application (e.g. Alt-F4, or 
Exit menu items) 

• Disabling access to the Windows Security dialog (Ctrl- Alt* Esc) 

• Disabling access to Windows keyboard shortcuts; especially including: 

a. Minimize all (WinKey + M) 

b. Lock workstation (WinKey + L) 
c. 

• Disabling access the Windows Display Properties dialog (e.g. access to altering display color 
depth and resolution settings, appearance preferences, themes, wallpaper, etc.) 

g) The runtime workspace will provide a "constrained Internet browser". While in "dedicated and 
controlled" desktop management mode, web pages from authorized (via DeitaV configuration) 
URLs will be displayed or accessible via hyperiinks^\ 

h) While in "dedicated and controlled" desktop management mode, any screen savers are disabled. 

i) Runtime workspace compliant applications do not provide access to the Windows folder and file 
properties dialog when performing any file browsing operations. They do not allow files to have 
their properties or security requirements changed, or be renamed or deleted, unless doing so 
cannot possibly damage the software or data installed on that workstation. 

4.3.2 Another Windows Application 

The "another Windows application" desktop management mode allows the runtime workspace to be used 
in conjunction with other Windows applications, by appropriately authorized and skilled personnel. 
Switching to this mode is useful for: 

• using the DeitaV system configuration applications (including workspace and display 
configuration applications) 

• gaining access to debugging features not appropriate for all users 

• troubleshooting the runtime workspace 

4.3.2.1 Userneeds 

a) To aid runtime workspace troubleshooting, the "another Windows application" desktop 

management mode supports all the features and interactive behaviors of the "dedicated and 
controlled" desktop management mode as much as possible. Conceptually, it Just removes 
constraints and adds extra features. 



Configurers are responsible for choosing non-runtime workspace applications to run that don't allow the operator 
to alter or delete files, launch still other "unconstrained" applications, etc. 

Goal here is to support users who maintain documents and web pages on intra-network servers; and still want to 
prevent uncontrolled roaming on the Internet. 
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b) While in the "another Windows application" desktop management mode, the user has access to 
the normal Windows desktop application management features; including: 

• Task bar. Start button, Run dialog, etc. 

• Windows key and Windows key shortcuts 

• Application minimization (including the runtime workspace) 

• Application switching (Alt-tab) 

• Unrestricted ability to change display properties 

• The ability to terminate the runtime workspace application(s) 

c) While in the "another Windows application" desktop management mode, there Is a mechanism to 
"spin ofT a new (detached) Windows application window on the Windows desktop, with the same 
content (display or runtime workspace application) as any of the framework panels (fixed or 
floating). This gives the user the ability to easily create content in new windows, where s(he) is 
responsible for window management (positioning, resizing, minimizing/maximizing, scrolling 
content within the window client area, closing, etc.) Once such windows are created, they no 
longer interact with or "track" actions In the runtime workspace framework. 

d) With access to the Windows desktop, users may "run" new instances of the runtime workspace 
application; choosing for it to start up in either "dedicated and controlled" or "another Windows 
application" desktop management mode: 

• When launched in "dedicated and controlled" desktop management mode, the Windows 
desktop will be controlled by the runtime workspace application, and other running 
applications will (probably) be inaccessible^^. 

• When launched in "another Windows application" desktop management mode, the user may 
run multiple instances of the runtime workspace application^^. 

e) All users may switch from the "another Windows application" desktop management mode to the 
"dedicated and controlled" desktop management mode (no security key is required.) The switch 
retains as much current workspace context (panel contents, recently used history, etc.) as 
possible. 

4.4 Internationalization Support 

Today, most "operations" features of the DeltaV system are available, localized to one of several 
languages. The runtime workspace, being the primary "operations" application, must continue to support 
the current language choices. It should also be expected that not all workstation/terminals/PDAs 
connected to a DeltaV system will want to have the runtime workspace use the same language choice^. 

Also, should technical support from EPM/AUS be needed to consult on a non-English DeltaV system, the 
English speaking technical support staff has the option of switching to, or running a separate English 
runtime workspace to facilitate communications^. 

4.4.1.1 Userneeds 

a) Users may choose one or more of the available DeltaV language options when installing DeltaV 
on runtime workspace-capable workstations or terminal servers. One language is the identified 

The user should probably close (or park) them appropriately before starting up a "dedicated and controlled" 
runtime workspace. 

For exan^le, taking advantage of multi-monitor hardware to use/test several single monitor display frameworks 
running in different instances of the runtime workspace application. Or perhaps run an English instance of the 
runtime workspace in parallel with a non-English instance, to assist English speaking troubleshooters. 

Since most engineering and administrative applications are available only in English, it seems quite likely that 
some users will want to run English runtime workspaces in non-English DeltaV systems. (Seems like this could 
facilitate technical support as well.) 

If this works pretty well, we may want to consider always installing English secondary language support on 
workstations in non-English DeltaV systems. 
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as the "dominant** language for the system; detemiining the standard and default configuration 
values for that DeltaV system. The dominant language must be the same for all DeltaV 
workstations in the same system. 

b) When an instance of the runtime workspace is started, the dominant language is automatically 
chosen by default, and all standard workspace behaviors and interactions use that language. 

c) It is possible to override the language choice for the runtime workspace with additional 
information provided at start up. It is also possible for a user to switch to another language for an 
existing runtime workspace Instance by selecting one (of those installed on this workstation) in 
the course of doing a "workspace hard reset** operation. 

d) When the workspace is running using a language other than the dominant language for the 
system, the workspace applications provide an interface (menus, dialogs, etc.) localized for the 
chosen language. Information content that is determined by the DeltaV system configuration, 
such as: 

• Area, module, node, DST, FF device names 

• Module, node, FF device descriptions 

• User enum state names 

• Alarm parameter names, alarm words, priority words 

• Batch procedure/recipe names, grade names 

...still retain their configured names (presumably compatible with dominant language.) 

Also, information stored in common system databases (available to multiple 
workstations/sessions) such as: 

• Event Chronicle databases 

• Batch Historian databases 

• Continuous History databases 

• Device Audit Trails 

...remain, and are displayed using the dominant language for the system. 

4.5 Workspace Framework 

The workspace framework provides a user configurable layout for how information is arranged within the 
runtime workspace; utilizing the available display area on the target display hardware. We anticipate: 

• Users will often choose one of the pre-engineered frameworks that are part of the default DeltaV 
configuration. Users (or system integrators) with special requirements or unique display 
hardware will design/configure their own framework(s). 

• Once a framework is chosen, it will be widely used within a DeltaV system (across many 
workstations/terminals having similar display hardware). This helps makes operators be more 
effective wherever they are working; and helps reduce training time and mistakes. 

• Displays will be designed with the framework (panel) dimensions in mind; building displays that 
will "nicely fit** the panels without a lot of •*stretching" distortion or having display elements end up 
being too big (wasting precious space) or too small (to read easily). 

• Even when different display hardware configurations are used In the same system, users will 
strive to use similarly sized panels across their frameworks, so that the same displays will render 
nicely on each hardware configuration; avoiding the effort of engineering separate displays for 
each. 



4.5.1 Framework Panels 

Framework panels are rectangular display areas where runtime workspace displays or applications can 
be made to appear. There are two types of framework panels: 

• Fixed panels: have a fixed location in the framework and area always visible (even If they have 
no content). Are not allowed to overlap other fixed panels. The collection of fixed panels in the 
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workspace framework is the visible "background surface" of an Instance of the runtime workspace 
application. 

• Floating panels: provide a means for a controlled number of temporary content windows that 
float over (obsuring) other panels. When the content in a floating panel is closed, the floating 
panel disappears. Floating panels may be configured to be movable: allowina the operator to 
move the floating panel away from it's anchor point, giving him more control^over the visible 
portions of all panels. 

4.5.1.1 User needs 

a) Framework panels are capable of showing several types of content at any point in time: 

• User configurable runtime workspace (graphic) displays. 

• Runtime workspace applications. 

b) Floating panels in the workspace framework have a configurable "use order". When two closed 
floating panels are othenvise equally eligible to be selected to display new content, the floating 
panel with higher precedence in the use order will be chosen. 

Fixed panels have a separate configurable "use order" to establish precedence. 

c) Through configuration, it is possible to categorize workspace display definitions and framework 
panels so that displays of a certain category will be automatically directed to appear in a fixed or 
floating panel with a matching category name^^ when a destination panel is not otherwise 
specified. 

• One framework panel (fixed or floating) may be configured with 0 or more category names. 

• A display definition may be configured with 0 or 1 category names, 

d) It is possible to assign the same category name to several (fixed or floating) panels. If a new 
display's category matches several panels, the display is directed per the sequence: 

• If a fixed panel that currently has no content matches the new display's category, the the new 
display will replace the old content in that fixed panel. Fixed panel use order will resolve 
which fixed panel to use if more than one is eligible. 

• If a floating panel that is currently closed matches the new display's category, that floating 
panel will be opened with the new display conent. Floating panel use order will resolve which 
fixed panel to use if more than one is eligible. 

• If a floating panel that is currently open matches the new displa/s category, that floating 
panel's content will be replaced with the new display. If more than one open floating panel 
matches, the one with the oldest content will have it's contents replaced with the new 
display^. 

• If a fixed panel matches the new displa/s category, the new display will replace the old 
content in that fixed panel. If more than fixed panel matches, the one with the oldest content 
will have it's contents replaced with the new display. 

WGI - Maybe we should also have the option to let the operator select which panel a new 
display is going to open in. 

e) It is possible to configure panels to be the automatic "destination" for the workspace applications 
(e.g. diagnostics, batch operations, history view, etc.) 

f) One panel (either fixed or floating) in each framework is the "default destination" panel. When no 
speciflc panel is identified for new framework content and there is no category name match 
between the new content and any panel, new content appears on this default destination panel. 



At the cost of more window management responsibility. 

Users will tend to define display category names that reflect a combination of native display size and purpose. 
Supporting "round-robin" distribution of floating displays (of certain categories) to their corresponding floating 
panels. 
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g) When an instance of the runtime workspace is first started (or goes through a "workspace hard 
reset") initial fixed panel contents are displayed. Each fixed panel may have an "initial content" 
(e.g. workspace display, or application) defined in the framework configuration. The configured 
initial content for fixed panel(s) may be overridden with information provided at runtime 
workspace startup time. 

h) Framework fixed panels may be configured to have several border options to help delineate them 
from other fixed panels in the framework. Options include "no border". 

i) A floating panel's upper left corner initially appears at a configurable "anchor point" position in the 
workspace framework. 

WGI - Might be good to allow the association of floating panels to anchor points to be controlled 
by a scheme similar to the 'categories' which you have proposed above to associate displays to 
panels. So I could have maybe four anchor points with category TP'; any time I open a floating 
panel with category TP' it would select one of those matching anchor points according to an 
algorithm similar to that in d) above. 

j) Each floating panel is configured with a preferred size (height and width). It is also configured 
with a preference for how to choose the Intlal size: 

• Use native size: the native size of the display establishes the Intitial size of the floating panel 
window. (When the content has no "native size" (e.g. workspace applications) the floating 
panel's preferred size is used as the initial size. The floating panel display window will be 
constrained to not go beyond the workspace framework. 

• Use preferred size: the panel content is scaled (within any scaling constraints defined for the 
workspace) to fit within the preferred floating panel size, with possible gaps or scroll bars. 

k) Each floating panel is configured to be resizable or not. If the floating panel is configured to be 
resizable, it's window is rendered with a border suitable for use in window resizing operations. If 
the floating panel is not configured to be resizable, window resizing operations are not supported 
(the floating panel will always remain at it's initial size.) 

I) Some panels in a framework require a mechanism for user interactions with the panel. These 
include: 

• Closing the panel contents (e.g. floating panels) 

• Moving a floating panel 

• Picking the panel as the source or destination for a "copy contents to another panel" 
operation. 

• Panel content scaling or zoom operations. 

• Recall recent panel contents operations. 

• Open contents as new (Windows task bar) window^^ 

• Capturing a "snapshot" of the current contents. 

• Controlling the display of display layers. 

• Controls involving the "display using historical data" feature 

• Resizing floating panels (without dragging borders) 

• (other operations introduced in the future) 

Also, depending on available space, users may want title or caption information about panel 
contents, for example: 

• Display name 

• Currently selected object (e.g. module, node) name 



When the workspace is in "another windows application" desktop management mode. 
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Framework panels may be configured to have "information and tool button" bars. The content of these 
bars is configurable. When display area is extremely limited, a mechanism is available to let the tnfo/tool 
bar to be hidden or minimized. 

WGI - this seems to call for an (optional) toolbar per panel, wherein the buttons would be limited in scope 
to actions that affect their own panel. May also need a 'workspace global' toolbar for actions that have 
broader scope. 

4.5.2 Workspace Displays 

Workspace displays are the mechanism to provide very customized content (and supporting display- 
related logic) within the runtime workspace. Workspace displays are intended to be used for: 

• System specific "process graphic" displays: showing live process information and providing a 
means to manipulate process parameters. 

• Logical "control panels" (or "faceplates") for DeltaV modules, nodes, etc. 

• User customizable "pop-up dialogs" 

• System status and alarm summary information 

• Plant drawings or other documentation that may be annotated with live process information. 

(For details on what runtime workspace displays can be composed of, see the "Starbum Process 
Display Primitives and Components" concept document.) 

(For details on the features and capabilities of dispiay-related logic, see the "Starburn Process Dispiay 
Logic and Languages'' concept document) 

4.5.2.1 User needs 

a) Workspace displays have names used for identifying them: 

• Users selecting them from display list/tree browsers, wanting to find/open a display by name. 

• Used by display elements (like display launch buttons) to open another display 

• Used by display logic to pick the appropriate display for the current conditions 
Restrictions on display names should allow: 

• Them to be long enough to serve as their own description in a list of display names (allowing 
for localized names) 

• Characters that can server as delimiters (e.g. space, hyphen, underscore, etc.) 

• Upper/lower case preservation, but case-insensltlve comparisons. 

• Easily reversible conversions to/from legitimate file system names 

b) We can anticipate users defining a large number of displays for their DeltaV system. To help 
provide organization of these for the operator, a hierarchical folder/directory system should be 
supported. Since folder/directory names in such a system will serve as their own description, the 
restrictions on these names should be comparable to those on display names. 

c) Some workspace displays (especially those creating by importing process Instrumentation 
drawings from non-DeltaV applications) are likely to contain display elements^*' that are not 
always appropriate for display under typical conditions. Yet. for special conditions (or when used 
by engineering or maintenance personnel) getting access to this information would be valuable. 

Workspace displays will support display elements associated with "display layers"^\ The display 
configurer can segregate information into separate layers, and choose which layers are visible by 
default when workspace displays are first rendered in the runtime workspace. 



Information appropriate to the original drawing, but has little to do with the DeltaV system and the automatic 
process controls; e.g. piping tags, size and materials, manually operated valves, visual inspection points, etc. 
Similar in concept to the "drawing layers" features in CAD applications. 
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The runtime workspace will provide a mechanism, at the framework panel level, to indicate what 
layers are available in a display, and change which layers currently appear. For each layer, three 
levels of visibility is supported: 

• Hidden: display elements associated with that layer are not rendered. 

• Subdued: display elements associated with that layer are "ghosted" (configured level of 
transparency) behind any full view layers. 

• Full view: display elements are rendered with their normal (configured) color and 
transparency level (usually opaque) 

d) Workspace displays may be configured to offer special display layers automatically created by 
the runtime workspace. Special display layers provide an mechanism to add "smart features" to 
user configured displays with little extra display configuration work. Special display layers that 
should be considered include: 

• Auto "module controls": tiny module -faceplates" appear on top of display elements with data 
links to module parameters. (Automatically "weeding down" to at most one faceplate per 
module.) 

• Auto "trend views": small, semi-transparent real-time trend windows appear next to display 
elements involving numeric data links. Trend windows support interactions to quickly delete 
unwanted ones, drag to better position, increase size, make opaque, or launch the a full 
function process history view application In the appropriate panel. 

• Auto "alarm volume history": for each plant area and Unit associated with data links on the 
display, an active alarms by priority vs. time column chart is displayed; indicating when and 
where alarm bursts occurred. 

e) While the "fixed and controlled" nature of the runtime workspace framework Is intended to relieve 
operators of most window management activity, for some users it may be too rigid. Resolving 
and monitoring different process problems may call for more flexibility in using the available 
display space. 

Specialized "sub-panel" workspace displays may be configured. Though capable of containing 
typical display elements, they are distinct in that they contain panels that support the 
configuration and behaviors of framework fixed panels. 

Sub-panel displays offer a couple of features to help users better tailor the runtime workspace to 
the problems of the moment: 

• By choosing a sub-panel display, the operator can dynamically subdivide one of the panels in 
the framework into a pre-defined arrangement of smaller fixed panels. (Consider sub-panel 
display intended to subdivide the "main" display panel, into a row of "faceplate" sized panels 
on top, and a wide panel ideal for a trend window on the bottom.) 

• Once the panel contents have been defined in a sub-panel display, the operator can save the 
display (in temporary user-session display storage) for later use in the session. Essentially, 
instances of new displays, dynamically composed to address specific process monitor 
problems, can be created and reused by that userAworkstation/session. 

4.5.3 Workspace applications 

Workspace applications are the means to deliver task-specific, optimized, "ready out-of-the-box" user 
interfaces via the runtime workspace. These user interfaces require little or no engineering or 
customization between DeltaV systems. They also offer an opportunity for richer user interfaces; ones 
that would be difficult to accomplish through combining display primitives and components and display 
logic. 

Workspace applications differ from normal Windows applications in that: 

• They communicate with and their lifetime is controlled by the runtime workspace. 
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• Expecting not to be "full screen" applications, they take particular care to automatically adjust 
their user interface layout to best fit the panel area they are assigned to work within. When used 
in a floating panel, they make every attempt to provide a suitable layout within the initial preferred 
size configured for the floating panel. As the floating panel Is resized, they adjust their layout 
accordingly. 

• They follow the runtime workspace user Interface conventions for common actions (e.g. selecting, 
scrolling, scaling, etc.) so the entire workspace feels well integrated. 

• They follow workspace conventions for retaining user interface stale, so that "go back to last 
display" operations for panels work well. 

• Where possible they offer useful "tracking" modes of operation; where their content/focus 
automatically follows the system object (module, node. FF device, batch, logic solver, etc.) that 
has focus In other panels in the framework (usually the "main" or "default destination" panel). 
They offer a means to disable tracking mode. 

We would expect that adding new workspace applications would be used frequently as the capabilities of 
the DeltaV system increases. 
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5 Application Architecture 



5.1 Background 

From the beginning of the Starburn project It was acknowledged that we would be addressing several 
objectives. Although these objectives are a subset of what is presented at the beginning of this 
document, it is worth repeating what we understood at the beginning of the project. 

1 . Decouple Clients from Servers 

2. Improve Overall Configuration Integration 

A common framework 
Common controls 

Large System configuration performance improvements 

3. Support Multiple Development Centers 

Austin 
Leicester 
Philippines 
Pittsburg 

4. Separate Services and Functional Development 

Build and release services and applications separately 
Run builds independently at multiple sites 
SB Management would be separated as much as possible 
Integration of Code-sets on a weekly basis 

Only ship core DeltaV infrastructure build. -f- assemblies to remote sites, source code to be shipped 
as required 

5. Support Multiple DCS's 

DeltaV 
Ovation 

6. Address new functionality 

Operator Workstation Replacement 

Process Graphics based on Scalable Graphics Technologies 

Process Modules 

Abnormal Situation Prevention 



With these objectives in-mind we first tackled the task of building configuration applications (Operator 
Workstation Applications. Process Graphics, Process Modules, and Abnormal Situation Prevention all 
have configuration aspects to them). 

We started the effort by breaking the problem down into client-side and server-side models. The 
configuration application architecture is presented first followed by a more general model. 
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5.2 Configuration Applications 

5.2.1 Server-side Configuration Model 

The sen/er-side configuration model is shown in the following drawing. 
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Figure 34. Server-side Configuration Model 



At the lowest level of the model are the UnManaged C++ components - Objectivity, Database Schema, 
and Transaction interface. These layers have been with DeltaV from the beginning and will continue to 
be extended and utilized as new functionality is added to DeltaV. Since the Starburn development is 
being developed as managed code using the Net Framework and C#, it was necessary to put an interop 
layer into place. The IManaged Interface (XIVI) provides this function. The rest of the functions in the 
model address the service internee requirements. These are discussed below. 
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5.2.1.1 Managed Schema Model (ServerModel) 

For a service based model to be versionable and maintainable long-term, it is necessary for the internal 
schema to be published. In this layer the entire model for DeltaV configuration is exported into Server 
Schema XML. The model for doing this is illustrated in the following drawing: 

An example of server-side Object Model Is shown below. 



Published Server Model 
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Figure 35. Published Server Model 



Clients need access to the Server Schema. Since loading the entire schema is impractical for many 
reasons, another mechanism is needed. The mechanism is described in the Query and Commands 
sections which are described next. 

5.2.1.2 Query Processor 

The biggest change for clients Is the introduction of the Query Framework. ^As was described in the 
previous sections, the Query processor is written In C# and coded against the XM layer which in turn is a 
thin veneer C+-f layer interface between the managed world of .NET and the unmanaged XM classes of 
HawkDB. 
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These query objects are very dynamic. A client asks for a query to be executed and gets the result as 
XML. The client request identifies the .NET assembly and query. The framework loads the assembly if 
necessary and executes the query. This provides good decoupling of development paths. 

The Query engine is shown below. 







Figure 36. Query Model 



An example Query and it's returned result is shown below: 
Root Role Filters Role Property Requests Role 

Site.PlantAreas[name='AREA_A'].Modules(description, scanRate).blocks 



<Module name="MODr> 
<Properties> 

<description>control module</description> 

<scanRate>1 </scanRate> 
</Properties> 
<Role name="bIocks'> 

<Block name^'usagel'^ 

<Block name="usage2"/> 

</Role> 
</ModuIe> 

<Module name="M0D2''> 
</Module> 
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The Query semantics allow the user to specify whether the request is to register with the database for 
updates. 

We store xml chunks in the Query Cache. These chunks are loosely coupled by nature. The query 
objects created to load and save these xml chunks do nothing more. There's no business logic here. Now 
we produce/cache exactly the kind of data we want to transport around the system, ie XML. It's a flexible 
architecture that's extendable and can be molded by the client application writer to suit their needs. 



5.2.1.3 Command Engine 

The commands interface is used to command the database server to do things - for example to save a 
module, create a module, etc. An example command is shown below: 



Import System 

Import DeltaV.Config. Command 
Import. DeltaV.Config.Model 

Function createModule ( areaName, moduleName ) 
{ 

var area = Site.role(TlanlAreas").key{areaName) ; 
var mod = area.role(''Modules").Create(moduleName) ; 

} 



5.2.1 .4 Services - Import/Export, etc 

There are several functions supported by the database server that are best managed as individual 
services. These services include Import, Export. Download, Upload. Commission, Commission Fieldbus. 
etc. 

5.2.1.5 IVIultl-threaded Server 

The multi-threaded server code is designed to support many applications. For queries and commands a 
thread will be allocated for the duration of the command / query. For service such as import / export a 
thread will be allocated for the duration of the import / export. 



5.2.2 Client-side Configuration Model 

Server-side support is half of the solution. Clients need to be restructured to utilize the query / commands 
style of interface. The client-side configuration model is shown below. Generalizing this model leads to 
the Application Architecture - the subject of this chapter. Before describing the general model the key 
blocks in the Client-side configuration model will be discussed. 
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Figure 37. Client-side Configuration Model 



This drawing does not show the IDataltem and IDataSource layer that clients can take advantage of. 
These are described under the section Application Framework below. 

5.2.3 Client Model Schema 

Each configuration client is made up of many views that work together to allow the user to add structure, 
change properties, etc. Each view In a client has very specific display requirements. Although the data 
model behind the configuration clients is based on the Server Schema XML, the data model Is quite 
often not exactly the same (configuration clients often have additional items that the server schema has 
no knowledge about). In addition, each view in a client is normally interested in a small sub-set of the 
Server Schema. So how do we bridge these differences? The solution is to provide a Client Model 
Schema. As Is shown above, it is possible (but not necessary) to customize the client model schema for 
Tree Views. Diagram Views, Properties Views, etc. An example Client-side Schema is shown below. 



<Type name=TestTypeA'' serverType="ServerTestTypeA"> 
<Properties allServerProperties="F"> 
<Property name='name" dataType="strlng" sen^erPropertyMapping=''(name)" /> 
<Property serverPropertyMapping="(descriptlon)" /> 

<Proper1y sen^erPropertyMapping="SenferRole1[type=*Sen^erType2'](subProp1)' /> 
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<Property serverPropertyMapptng="ServerRole2[type=''ServerType3'](subProp2)* /> 
<Property name=''calcProp" dataType="string' oommand=''GetProp'' assembly="commands" l> 
</Properties> 

<Roles allServerRoles="F"> 
<Role name="Cli8ntRoler serverRo!eMapping="ServerRole3"/> 
<Role name=XIientRoIe2"> 

<ServerRole mapping="ServerRole4" /> 

<ServerRole mappings'ServerRoleS" /> 
</Role> 

<Role name=XlienlRole3' serverRoleMapping=''ServerRole6[type»*ServerType6T /> 
<Role name="ClientRole4' serverRoleMapping="ServerRole6[type='ServerType7']' /> 

</RoIes> 
</Type> 



Making use of Roles and Types to map from Server-side to Cilent-side Is illustrated in the following 
diagram. 
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Figure 38. Mapping Server-side model to Client-side model 



5.2.4 Client Model and Object Cache 

As the client loads Server-side schema and processes it using its own Client-side schema and logic, the 
client model and object cache are loaded up. An illustration of this is shown In the following diagram: 
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Figure 39. Client Model 



5.2,5 Command Framework 

The commands framework is used to create commands that are passed from the client to the server. 
Examples of commands include "Import ModA", "GetBitMapCmd()'. etc. The example below illustrates a 
client looking up a command to get a bitmap. 
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Figure 40. Command Framework 



5.2.6 Configuration Framework 

The Configuration Framework provides a common set of classes and interfaces that developers use to 
create DeltaV configuration applications. Taken together, the classes, interfaces and patterns contained 
in the Configuration Framework make up an "Application Framework". Software engineers that develop 
DeltaV configuration applications will use this framework as a basis for building their DeltaV configuration 
applications. At a very general level the Configuration Framework provides a skeleton for an application. 
It Is the job of the application developer to fill in the specific details required to create a functional 
application. The Configuration Framework will support Longhorn applications developed using the C# 
programming language. 

A simplified view of the Configuration Framework Is shown below: 
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Figure 41. Configuration Framework 



Details on the Configuration Frameworl< are provided below. 

5.2.7 Package 

The Package contains the functional logic for the application. For example, if this was Control Studio, 
this would be the Control Studio configuration logic. 

5.2.8 Views 

Applications are made up of many cooperating views. These views work together through the package 
and client model to perform the actions as requested by the users. Views will generally be based on a 
common control such a Diagram Control, Tree Control. Properties Control, or Grid Control. 
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5.3 Functional Breakdown of Applications 



The application architecture is a set of frameworks, patterns, and styles to properly use the Technical 
Architecture and build Starbum configuration, operator, control, etc interfaces. The application 
architecture needs to be flexible enough to deal with very large scale applications (e.g. our configuration 
applications with 1000's of classes), heavy use and strong performance requirements (especially our 
operator Interface applications where more than a 1 sec response is considered unacceptable), and data 
consistency and integrity requirements (in the case of configuration a supporting transaction model is 
required, in the case of runtime confirmation or acknowledgement is required — user changes cannot get 
dropped on the floor). 

The general model for applications is illustrated below: 




Application (ao. Enptarar) 



Figure 42. Application Architecture - Siiown witli DeltaV Explorer 



There are many aspects to what is shown in the drawing above. Everything to the right is described in 
the Technical Architecture. Everything to the left is part of the Application Architecture. 
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DeltaV applications themselves should be viewed as a set of isolated reusable components. 
Components will be developed independently of each other and the applications that use them. Any 
individual component can make use of core services or other shared interfaces (for example the client 
model). They may also provide plug-In points for extensibility. 

Functional components can be tested in Isolation and developed independently of each other and the 
applications that use them. Development of these components can be moved to other geographical 
areas. 

5.3.1 Controls 

Many of the views in applications repeat across many applications. For example the Diagram Control is 
used in all of the Module Editors. Process Graphics, as well as other applications. A partial list of controls 
includes: 

1- Diagram Control 

2' Properties Control 

3- Tree Control 

4- Grid Control 

5- Structured Text Control 

5.3.2 Views 

Many of the views in applications are repeated across applications. For example, the parameters dialog 
should be the same across all DeltaV configuration applications. A list of common dialogs includes: 

1- About dialog : The About dialog and property pages are on all applications. 

2- Fieldbus dialogs : There are many Fieldbus dialogs for showing device and resource information. 
These dialogs need to be the same regardless of which editor is invoked. 

3- File dialog : The file dialog is customized for DeltaV - in the case of the Database it's to open 
database things. 

4- Hart dialogs : There are many Hart dialogs for showing device. These dialogs need to be the 
same regardless of which editor is invoked. 

5- License dialogs : Licensing dialogs are invoked from many applications - in some cases from 
several locations within the same application. 

6- Parameter and Property pages : Property dialogs are shareable components which are usable 
from any application. Each property dialog is tied to a particular configuration data type. 

7- User preferences : User preferences are set on applications - they should work the same 
everywhere. 

8- Wait and Cancel dialogs : From time-to-time applications take extra time to complete. When this 
happens Wait and Cancel dialogs need to be invoked. 

5.3.3 Browser 

There is a single reusable Ul browser component which can be used to provide the Ul to multiple 
separate item browsers. There are multiple reusable browser models, each of which determines the 
behavior of a browser for a particular type of item. There are multiple browser data source adapters 
allowing the browser to browse into multiple data sources. 

An application brings together a browse data source with a reusable browser model and the reusable 
browser Ul in order to browse for a particular class of item. 
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5.3.4 Download 



There is a reusable Ul component which can drive the server download process. The download 
component can be called by any application, passing the server data handles to items to be downloaded. 
The download component will provide user feedback and sequencing for the download process. 

The Ul download component makes use of the download core service. 

5.3.5 Drag/drop 

There Is a common drag/drop format used by all DB operations. There is a Ul command which will call to 
the server conftg model to determine whether drop is allowed and to action the drop if It occurs. The 
configuration model in the database server understands enough of the semantics to perform the correct 
action when a paste occurs. 

5.3.6 C ut/copy/paste 

There is a common paste buffer format used by all DB operations. There is a Ul command which will call 
to a database data access function to determine whether paste is allowed and to action the paste if it 
occurs. The configuration model in the database server understands enough of the semantics to perfomn 
the correct action when a paste occurs. 

5.3.7 Other Ul commands 

User interface commands are shareable components which are potentially usable from any application. 
Each command contains the user interface and knowledge of client schema commands necessary to 
perform a particular action in a particular context. 

5.3.8 Application 

Applications build on the shared components identified above. Examples of DeltaV applications are 

• Explorer 

• Control Studio 

• Diagram Editor 

• Process Module Editor 

• Operator Graphics 

• Expert Systems 

Applications are developed independently in the same way other components are developed. 
5.4 Configuration Framework 
5.4.1 Overview 

The Configuration Framework is being designed to support client applications that use different data 
stores - sometimes more than one in the same application. With this in mind it's clear that the 
configuration framework cannot require the client developers to have a dependency to the runtime or the 
client model. The framework will be implemented in a way that allows application developer to pick and 
choose pieces that are needed depending for an application. For example developers will be able to use 
the docking framework with out being forced to use the command management or user preferences. 
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The configuration framework will have several layers that build upon each other. These layers are 
illustrated in the diagram below and then followed with an explanation. 



Configuration Frameworic layers 
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Interface layer 

Interface definitions 
No dependencies 
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Starburn Databound Controls Layer 

Extension of the common 
Controls that will data bind to any 
implementation of IDataSource 



Data Model layer 

Implements IDataSource and 
IDataltem for the ClientModel 
Dependency on client model. 



Figure 43 Configuration Framework Layering 



The first level will define the interfaces used by all subsequent levels. Next is the level that contains all 
the common controls and extension of .NET controls. In some cases such as a tree control, this may be 
little more than providing defaults to certain properties so alt applications have a similar look and 
behavior. Other controls will be composite controls such as a palette control or new controls that do not 
exist in .NET such as an intelliSense control, diagram control, and frameworks for docking and command 
management. 

The next level will extend the controls in the previous level's controls that utilized several in house 
interfaces to allow them to bind to object models that provide implementations of the interfaces. These 
are the Interfaces such as IDataSource and IDataltem. Although this level will be able to bind to Starburn 
data models this level does not have a dependency to the client model or runtime. 

A default implementation of the binding interfaces using the client model will be provided since many 
configuration applications will use the client model. This implementation can be used directly or extended 
as necessary by client application developers. This portion of the framework will have a direct 
dependency to the client model. Clients that use the databound portion of the framework will have at 
least an indirect dependency on the client model. 

It is possible for client applications or other components to use the framework in any of the following 
scenarios or combinations: 
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(1 ) Interface layer - The interface layer is ttie glue between controls and the data models, allowing 
the Ul portions of the framework to be Independent of the data models. Developers may 
implement or use one or more interfeces to allow the framework to interact with the data or 
application. 

(2) Common. Controls layer ~ The client application uses common controls provided by the 
Configuration Framework. There is no other dependency on DeltaV or the data that is rendered 
in the controls. For instance, a client could populate the data manually or use .NET data binding 
to data bind the control to a SQL database or XML file. The client application would inherit the 
look, feel and behavior of the common controls in their application. This layer will contain features 
such as docking, command management and controls. 

(3) Starburn Databound Controls layer - The client application uses controls provided by the 
Configuration Framework IDataSource layer. There Is a dependency on the control and the data 
rendered in that control. The dependency is that the data rendered In the controls uses 
IDataSource and IDataltem. 

(4) DataModel layer - The client application uses data from the ClientModel. The client application 
could write their own controls to display the data or use the IDataSource controls provided by the 
framework. 

Developers will be able to use portions of the framework without the requirement to use everything. For 
Instance the docking will not depend upon the command management. Common controls can be used 
with or without the Starburn data binding. Additionally, the controls can be used without requiring the 
data binding interfaces to be implemented. 

5,4.2 Assembly Dependencies 

The Configuration framework will be divided Into several namespaces. The assemblies will be divided to 
allow development of client application that do not have a dependency, even indirect, to the client model 
or runtime. All client model specific implementations will be in the DeltaV.CfgEnv.ClientModel assembly. If 
necessary a DeltaV.CfgEnv.RuntimeModel assembly will be created that has a runtime dependency. 
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Figure 44 Package Dependencies 



DeltaV.CfgEnv.lnterface: This interface assembly contains all interfaces implemented by the Core 
package, used by the clients as well as any interfaces that the client must implement. 

DeltaV.CfgEnv^Controls.Common: This assembly implements common controls and extends .NET 
Framework controls to conform the Ul Guidelines. The class can be used directly or indirectly in client 
applications. Examples are tree controls, palette control, intellisense controls. At this level the controls do 
not implement in house data binding. This assembly and these classes do not have any Starburn or 
DeltaV specific dependencies. This assembly can be used directly by a client application and will not 
create a direct or indirect dependency to the runtime or client model. 

DeltaV.CfgEnv.Controls.DvBindIng: This assembly implements extends the common controls in the 
Core.Common assembly and uses the In-house data binding interfaces, IDataSource. to automatically 
load, update and send events load. These classes do not have specific any specific Starburn or DeltaV 
dependencies. This assembly can be used by client applications and will not create a director or indirect 
dependency to the runtime or client model. 

DeltaV.CfgEnv.ClientlVlodel: The configuration client model package will provided a default or base 
implementation of the Starburn Configuration framework defined data binding interfaces that interact with 
the client model. This assembly will provide additional framework for those client applications that use the 
client model as their data source creating a dependency to the client model. 
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5.5 Browser Framework 



The Starburn Browser will consist of a Browser framework. Browser View, Individual Browser 
DataSources and packages for different Browser Types. The Browser View will query the Browser 
Framework for specific information to display. It is possible to develop Windows based or Web based 
Browser View, using the same underline business logic in the Browser Framework. 

The Browser Framework defines the contracts between the Browser and individual Browser Data 
Sources. The Browser Framework communicates to Browser DataSources to extract information for 
the Browser View via the interfaces defined in the contracts. The realization of these interfaces lies in 
each data source. 

For each application that utilizes the Browser, there will be a set of packages to facilitate different browser 
types within that application. For instance, there will be a ModuleBrowser package for the module 
browser of DeltaV Explorer, where the context menu of the Module Browser will be constructed by the 
objects within the ModuleBrowser package. The execution of the context menus will be captured in the 
specific Browser DataSource. Code re-factorization will take place in the future to maximize code- 
sharing. 

There will be a Browser Framework that contains the contracts (interfaces) between the browser and 
individual data source. 

Here is a brief look of the project layout: 

\Starbum 
\Core 
\Mainline 
\BrowserFramework 
\Browser 

\BrowserOataSource 

\BrowserView 
\Mainline 

\ClientModel 
\Mainljne 
\Browser 
\ClientModelBrowserOatdSource 

\DeltaVExplorer 
\Mainllne 
\Browser 
\Packages 
\AttributeBrowser 
\ModuleBrowser 



\ProcessGraphicsDataSource 
\Mainline 
\Browser 

\ProcessGraphicsBrowserDataSourc8 

\ProcessGraphicsEditor 
\Main!lne 
\Browser 
\Packages 
\PumpBrowser 
WalveBrowser 
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To facilitate multi-version development, the current plan for output of the projects is: 



\bin 

VDeltaV.CIientModei 

ctientmodel.dll 
\DellaV. BrowserFramwork 

browserframework.dl! 
\OeltaV.CjientModel.Browser 

clientmodelbrowserdatasource.dll 
\DeltaV.Explorer 

exp.exe 
\DellaV,Explorer.Packages 

moduiebrowser.dll 

attributebrowser.dll 
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6 Technical Architecture 



6.1 Background 

The Starburn project extends the DeltaV core using a service-oriented approach. Service-oriented differs 
from Object-oriented primarily in a several ways: 

1- Service-oriented architecture emphasizes loose coupling vs. Object-oriented which emphasizes 
reuse. 

2- Service-oriented architecture share schema and contract vs. Object-oriented which share 
classes. 

3- Service-oriented architecture views an application as a system that is built from autonomous 
services vs. Object-oriented which views an application as a program that is built from class 
libraries. 

4- Service-oriented architecture views communication as expensive and explicit vs. Object-oriented 
which views communications as cheap and implicit (e.g. DCOM's marshal by value approach). 

5- Service-oriented architecture views deployment as an on-going process vs. Object-oriented which 
views deployment as a unit. 

The notion that communication is expensive not only applies to Inter-service communication which may 
be spread out across several nodes or potentially over a wide-area network, but to developer 
communication. Even in scenarios where services run on one node or at most on a few nodes connected 
together across a LAN, developers may be distributed across geographical and organizational 
boundaries. Each type of boundaries increases the cost of communication. Service-oriented 
architectures adapt to this model by reducing the number and complexity of abstractions that must be 
shared across service boundaries. The number of Interfaces and the number of methods available which 
each interface is kept as small as possible. 

During the 1990's Object-oriented programs such as DeltaV made huge strides in carefully constructing 
class hierarchies' emphasizing reuse. A side-effect of this however was close coupling. Although it was 
possible to build applications to be independently deployed this was not the normal case. A Service- 
oriented approach addresses this problem differently. Duplication is considered more favorable than 
coupling. 

Service-oriented architecture views deploying applications as an ongoing process. It is expected that 
applications will be versioned Independently from core services. While services themselves will continue 
to be distributed as a whole, the aggregate state of the overall system and applications will be mixed. It 
will be common for services to be deployed long before applications are available to make use of them. 
Services and applications are also expected to evolve over time. The degree to which services can be 
updated and new services introduced depends on the complexity of the service interaction and the 
ubiquity of the services, i.e. what has to be present at the same time in order for a feature or application 
to function correctly. The great risk with services is that "assumptions" will be made about their use which 
in tum become expected behavior over time. It is Important to keep the Interfaces as simple as possible 
so that both services and applications can be versioned with these "assumed" side-effects. 

Services share schema and contract not classes. In the Object-oriented paradigm developers create 
classes which in-turn share both structure and behavior in a single named unit. In the Service-oriented 
paradigm services interact based on schemas (for structure) and contracts (for behavior). Every service 
publishes a contract that describes the structure of the messages it can send and receive. The ordering 
of the messages must be carefully document. Contracts and schema often make use of XML. 

There are downsides to this decoupling as well. Unlike traditional class libraries a service must be careful 
to validate input data on each message. Once defined the names and signatures of services must 
remain constant across all space and time. 
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6.2 DeltaV Concept for Service-oriented Architecture 

As described in the previous section entitled "Background on Service-oriented Architecture", the DeltaV 
services concept is to divide the system into loosely couple segments. Each segment has a clearly 
defined external interface that can be tested and versioned. The entire DeltaV system is made up of 
segments that build on other segments. Each segment can be tested in isolation through its interface. 

Two kinds of segment are identified. Core DeltaV functions are presented as services and user 
applications are broken down into functional groupings. 

Core DeltaV functions, such as configuration database access, runtime access, history access, are 
implemented as services which are available to client applications through service interfaces. These 
service interfaces are designed to be generic In nature and their signature to be entirely independent of 
the schema of data in the configuration or runtime database. These service interfaces should therefore 
need to be changed If new service capabilities need to be added, not if new data objects are added to the 
DeltaV system. 

The services Identified for DeltaV consist of the following: 



1- 


Discovery Service 


2- 


Session Service 


3- 


Runtime Services 


4- 


Database Services 


5- 


Versloning Services 


6- 


Historian Services 


7- 


Historian Scanner Service 


8- 


Alarms and Events Services 


9- 


OPC Data Services 


10- 


XML File Services 


11- 


HTTP Links Services 



Each of these services will have a very specific interface defined for It. System Services implementing 
these services will follow the service interfaces. This allows clients to remain constant even when 
services are swapped out. For example, as part of the DeltaV and Ovation installations, specific 
installations of the Service Providers will be installed. This is illustrated in the drawing below. 
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Figure 45, Implementing System-specific Services 

The following enumerates the expected service Interfaces which will be provided and the functions to be 
available on each. This section is meant to serve as a brief introduction to the services. A more in-depth 
discussion of the services is provided in the following sections. 

6.3 Services 

6,3.1 Discovery 

The discovery service provides two key functions - it provides support for registering services on each 
node and it provides a general query mechanism for locating services locally as well as anywhere in the 
system. 

Services are located by their URL Examples of the URI are shown below: 
Identitv Role 

Soap:/Avww.contoso.com/pppp/whatsnew.aspx?date=today 
II II {-optional query string 

I I I |-path identifier 

I I l-port 
I |-server identifier 
I- 

Transport address for http 
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Soap.http://www.contoso.com/ppppAvhatsnew.aspx7date=today 
III II |-optional query string 

III I |-path identifier 

I I I l-port 
I I |-server identifier 
I |-scheme identifier 



Transport address for Starbum/DeltaV 
We have our own scheme identifier. 



Soap.starburn://hostname:pppp/whatsnew.aspx?date=today 
II III |-optional query string 

II II |-path identifier (our sen/ice names) 

I I I l-port 

I I {-server identifier 

I |-scheme identifier 



The Discovery Service model is shown below. 



«8orvlQe He»t» 
Dlscovvry Sttrvico 



«s«rvtca» 
Di»cov«ry 

(Nodo Ntme. {Local 
Servers}} 

roglstorS«rvlc« 
leeaCaSMvIc* 
puMlshS«rvlc« 



«SmvIc* HMt» 
Runtim* 8«fVttr 



0|Mn(8essionH.c«llbaek> 



AddGroup<GroupNam«»*GroupH) 
Addttam(GroupH.(lt»fn}*ltamH) 
Readlt*ni<ItefnH) 
Writelt«m(ttemH) 
8ynchRead(lt*mH) 
8yncWrtta(ttamH) 
ReniovaGroup(GroupH) 
Broadcaatat^Locata-.-Sarvicartame") 



Figure 46. Discovery Service 
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These services are described below. Scenarios are then presented ilfustrating how the services are 
used. 



6.3.1.1 Service Descriptions 

6.3. 1.1.1 Data Access 

The data access service provides an interface to allow querying for information about the services that 
are Installed on each node. If the service is not located on a specific node there is mechanism for 
locating the service in the system. 

6.3.1 .1 .2 Discovery Service 

The discovery service provides an interface for registering services on each node. 

6.3.1 .2 Scenarios 



6.3.1 .2.1 Register Service 




Figure 47. Discovery Service - Register Service 



6.3.1.2.2 Locate Service 
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Figure 48. Discovery Service - Locate Service 



Zones 

Zones publishing service 
Gateway device 



6.3.2 Session Service 

Session is a complex service. The part of session described here loads into each client and tracks the 
privileges for that application/user combination. The actual session object is held and controlled by the 
runtime. This separation allows for running clients [at least in Debug mode] without the runtime being 
available. 

The Session Service model is shown below. 
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Figure 49. Session Service 

These services are described below. Scenarios are then presented illustrating how the services are 
used. 

6.3.2.1 Service Descriptions 

6.3.2.1.1 Session 

The session service provides an interface for logging in/out of DeltaV. 

6.3.2.1.2 Session Manager 

Session Manager provides a single session object for all services referenced by the same application. 

6.3.2.2 Scenarios 

6.3.2.2.1 User Logs In as 'Userl' 

6.3.2.2.2 User Launches Application 'DeltaV Explorer* 

6.3.2.2.3 User Launches Application 'Process Graphics' 
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6.3.2.2.4 User Logs In as 'User2' 

6.3.2.2.5 User Logs Out 



6.3.3 Runtime Services 

The Runtime Services provide access to the local and remote runtime information. The. 
The Runtime Service model is shown below. 
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Figure SO. Runtime Services 



These services are described below. Scenarios are then presented illustrating how the services are 
used. 



6.3.3.1 Service Descriptions 
6.3.3. 1 . 1 Data Access 
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The runtime data access service provides an interface to allow the reading and writing of parameters in 
the runtime database, and to enumerate certain collections of items in the runtime database such as 
commissioned controller nodes. 

1 . Clients need to form a session associated with the current user. When the session is formed a session 
handle is returned (^sessionHandle). 

2. The runtime supports the following functions: 

Locate (modules, DSTs, etc) - get back a server handle to the item that has been located 
Register for change notifications 
Synchronous calls 
Download / Upload 
- Etc 

3. Support local and remote data through a local service 

4. Support multiple items in lists 

6.3.3.1.2 Administration 

The runtime administration service provides an interface to allow commissioning and decommissioning of 
devices. 

6.3.3.1.3 Configuration 

The runtime configuration service provides an Interface to all configuration download. 
6.3.3.2 Scenarios 
6.3.3.2.1 Scenario 1 

6.3.4 Database Sen/ices 

The overall database services are shown in the drawing below: 
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Figure 51. Configuration Architecture 



There will be a database server, equivalent to today's DvDbServer. The following are the primary 
interfaces available on this server. 

The Database Service model is shown below. 
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Figure 52. Database Services 



These services are described below. Scenarios are then presented illustrating how the services are 
used. 

6.3.4.1 Service Descriptions 
6.3.4. 1 . 1 Data Access 

The data access interface contains functions to query and update the database. 

The query function allows the database to be queried using our query syntax and the result return as an 
XML stream which is interpreted by the client model. 
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The command function allows commands issued by a client to be executed against the database in the 
server. A single command is made up of multiple navigation and update operations against the database 
and executes in a single database transaction. A command is composed in the client and sent as a string 
which Is interpreted as a script in the server. A command will usually be parameterized so that a single 
script can be used for all similar operations. The server may cache and pre-compile scripts as a 
performance optimization. Any update command can trigger a callback onto a client interface if version 
control actions are required as a result of the command executed. 

6.3.4.1.2 Download 

Download will be implemented as a sequenceable interface in the server. The interface to download will 
include instructions to add items to a download list; to check for and perform uploads, to check 
dependencies, to verify the download and to actually send download items to the DeltaV system. 

This service will make use of the Runtime Data Access service to perform uploads, the runtime 
Administration service in order to ensure that devices are commissioned and the Runtime Download 
Service to actually send the download scripts. 

6.3.4.1.3 Export 

Export will be implemented as a sequenceable interface in the server. The interface to export will include 
instructions to add items to an export list and then to perform the actual export. There will be a callback 
interface on the client to write the export file for the server and to report the progress of the export. 

6.3.4.1.4 Import 

Import will be implemented as a sequenceable Interface in the server. The interface to import will include 
instructions to specify the import file and import options and then to perform the actual import. There will 
be a callback interface on the client to read the import file for the server and to report the progress of the 
import. 

6.3.4.1.5 Version Control Administration 

A version control Interface interface provides instructions to administer version control. 

6.3.4. 1 .6 Database Administration 

An administration interface on the server will give access to database administration functions; such as 
creating, deleting, backing up and restoring databases. 

6.3.4.2 Scenarios 

6.3.4.2.1 Scenario 1 



6.3.5 Version Control Service 

The version control service provides an interface to allow storing and retrieving version information 
information. The Version Control Service model is shown below. 
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Figure 53. Version Control Server 

These services are described below. Scenarios are then presented illustrating how the services are 
used. 

6.3.5.1 Service Descriptions 

6.3.5.1.1 Session Service 

6.3.5. 1 .2 VersionControlServlces.Administration 

6.3.5.1 .3 VersionControlServices.Version 

6.3.5.1 .4 DatabaseServer.VersionControl 

6.3.5.1.5 VersionServer. Version 

6.3.5. 1 .6 VersionServer.Administration 
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6.3.5.2 Scenarios 
6.3.5.2.1 Scenario 1 



6.3.6 Historian Service 

The history access sen/ice provides an interface to allow querying for historical information 
The Historian Service model is shown below. 
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Figure 54. History Server 



These services are described below. Scenarios are then presented illustrating how the services are 
used. 



Service Descriptions 
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6.3.6.1.1 Data Access 



6.3.6.1.2 Data Write 

6.3.6.1.3 Administration 

The history administration service provides an Interface for adnninlstering history collection, including 
creating, deleting and nnoving archives of historical data. 

6.3.6.1.4 Audit 

6.3.6.1.5 Innport 

6.3.6.1.6 Export 

6.3.6.1.7 Configuration 

The history configuration service provides an Interface to allow history collection characteristics to be 
specified. 

6.3.6.2 Scenarios 
6.3.6.2.1 Scenario 1 



6.3.7 Historian Scanner Service 

The historian scanner service does not provide any services. It requires services from Session, Runtime 
and Historian. 

The Historian Scanner Service model is shown below. 
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Figure 55. History Scanner Service 



These services are described below. Scenarios are then presented illustrating how the services are 
used. 



6.3.7.1 Service Descriptions 



6.3.7.2 Scenarios 



6.3.7.2.1 Scenario 1 



6.3.8 Alarms and Events Services 

The alarms and events data access service provides an interface to allow the reading alarm information 
from the alarms and events server. 

The Alarms and Events Service model Is shown below. 
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These services are described below. Scenarios are then presented illustrating how the services are 
used. 

6.3.8.1 Service Descriptions 

6.3.8. 1 . 1 Data Access 

6.3.8.1.2 Administration 

The runtime administration service provides an interface to allow commissioning and decommissioning of 
devices. 

6.3.8.1.3 Configuration 

The runtime configuration service provides an interface to all configuration download. 

6.3.8.2 Scenarios 
6.3.8.2.1 Scenario 1 

6.3.9 OPC UA Data Services 

The OPC UA data access service provides an interface to allow the reading and writing of parameters in 
the runtime database. 

The OPC UA Service model is shown below. 



These services are described below. Scenarios are then presented illustrating how the services are 
used. 

6.3.9.1 Service Descriptions 

6.3.9.1.1 Data Access 

6.3.9.1.2 Administration 

The runtime administration service provides an interface to allow setting up the OPC interfaces. 

6.3.9.1.3 Configuration 

The configuration service provides an interface to configure OPC Servers. 



120 



6.3.9.2 Scenarios 

6.3.9.2.1 Scenario 1 

6.3.10 XML Files Service 

The XML file service provides an interface to read from XML formatted files. 
The XML Files Service model is shown below. 

These services are described below. Scenarios are then presented illustrating how the services are 
used. 

6.3.10.1 Service Descriptions 
6.3.10.1 .1 Data Access 

6.3.10.2 Scenarios 

6.3.10.2.1 Scenario 1 

6.3.1 1 HTTP Link Services 

The HTTP service provides an interface for reading and navigating HTTP Links. 
The HTTP Service model is shown below. 

These services are described below. Scenarios are then presented illustrating how the services are 
used. 

6.3.1 1 .1 Service Descriptions 

6.3. 1 1 . 1 . 1 Data Access 

6.3.11.2 Scenarios 
6.3.11.2.1 Scenario 1 
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6.3.12 Server versioning 

There is a separation between server interface versions, server schema versions and server build 
versions. 

• If a server is updated as a bug fix, then the server build version is changed. 

• If the server is updated to add new database schema components (new items to be configured), 
but the interface to the database service is not changed, then the server schema and the build 
versions are changed. 

• If new functions are added to existing server interfaces, or new interfaces are added to a server 
then the server version is changed also. 

Generally a server build version change should require no change to any client applications. 

A server schema change, providing it is only adding to the existing schema should not require that 
existing client applications be updated. Schema changes which modify existing schemas should be 
avoided if at all possible. If schema changes occur they will affect applications using that portion of the 
schema. 

A server interface change, providing that it is adding to existing functions on an interface, or adding new 
interfaces to the server should not require that existing client applications be updated. Interface changes 
which modify an existing interface should be avoided If at all possible. If interface changes do occur they 
affect applications which use the affected functions. 

This behavior means that for the vast majority of server changes, existing applications should continue to 
work with new versions of a server. 

6.3.13 Client interface to server 

For each sen/er interface there is built a reusable client Interface assembly which encapsulates client 
access to that server. Client applications will use these client assemblies rather than communicating 
directly with the service interfaces of the server. Client interface assemblies will be versioned. 
corresponding to versions of the server interface. A client machine can have multiple versions of a client 
interface assembly active simultaneously; each application will be bound to versions of the client interface 
assembly that it expects. 

6.4 A service example 

The following discussion briefly describes services. Examples are used to illustrate concepts described in 
this document. 
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6.4.1 Framework 




void DisposeO 




void .open(intse5sionH) 

votd.ctoeeO 

string Ji^ {QBt;} 

vdd.tBStFofOpenO 

vofd.tBstFoiClGsedO 



.sefvices 





in (.handle 



.seBsions 



Session 1his(htse5sionH]{get set } 



sting .ifieiName 
siring .^plicalionName 

SeiviceBase ffibfstring Icey] {get; set } 

void Login^tring iseiNamG^ string appName^ out intsGssiaiH) 
void LogoulO 



6.4.1 .1 ServiceBase 

All Starburn services inherit from ServiceBase and with the exception of the Session service all services 
must have an Open and a Close method. 

The minimal implementation of Open Is shown below 



[ServiceMethod] 

public void Open(int sessionH) 

{ 

_testForClosed(): 
.open(sessionH); 

} 



The minimal Implementation of Close Is shown below 



[Sen^iceMethod] 
public void CioseQ 
{ 



Figure 56. Service Architecture Framework 



JestForOpenO; 
. _close(); 



} 
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Every service must implement the _key property to return a string uniquely identifying the service with the 
server. 

Every server other than Session must call _testForOpen() at the beginning of a server method or 
message. 

Service classes are decorated with a custom attribute indicating the kind of service they provide, the 
name and namespace, for example 

[DialogPortType(Name = "DataAccess", Namespace = "http://tempuri.org/DeltaV/Database/OataAccess")] 
public dass DataAccess : ServioeBase 



This will produce a service description IDataAccess in the namespace DeltaV.Database. DataAccess 

6.4.1.2 Session 

Every Starburn service server will include a Session service. This is a special service used to coordinate 
the other services within the server and validate security credentials. 

A client application connects to the server at a specific URI and asks for the Session service interface. 
The Session service has two service methods Login and Logout. 

Login will perform the necessary security validation and establish (or connect to) a runtime session for the 
caller. A session handle is returned. 

When the client opens another service interface within the server it must pass in the session handle. 
Internally the new service is added to the session. At logout any services used by the client that have not 
been explicitly closed are closed. 

6.4.1 .3 SessionManager 

The Session Manager keeps track of active sessions within a host. 

6.4.1.4 Proxy 

Each service must provide a proxy to be used by client applications that interact with the service. The 
proxy is generated automatically from the service definition using the wsdlgen.exe tool. 

A service is built into a .net assembly. The service assembly project has a post build step that generates 
the service description .wsdl and .xsd files into the service source code directory. 

BuildServiceDefinition.bat below demonstrates how the service definition for the Session service is 
generated. 



@echo off 
d: 

cd \DeltaV\code\Starbum\Session 

°%SDKTOOLPATH%\wsdlgen.exe*' /nologo D:\deltav\code\bin\DeltaV.Session.dll 
if errorievei 1 goto ReportError 
goto End 
: ReportError 

echo Project error: A tool returned an error code from the build event 

exit1 

:End 



This generates the following files 
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• tempurLorg.DeltaV.Session.wsdl 



• tempurl_org.DeltaV.Sesslon.xsd 

• schemas_mlcrosoft_com. serialization. 2003.02. DefaultDocumentElement.xsd 

A Proxy project Is built in the directory below the service. The project contains a prebulld step that 
generates Proxy.cs from the service description in the directory above. This Is compiled Into the service 
proxy assembly. 



"%SDKTOOLPATH%\wsdlgen.exe" /nologo /o:$(ProjectDir)Proxy.cs $(ProjectDlr)..\tempurl_org.DellaV.Sesslon.wsdl 

$(ProjectDir)..\schemas_microsoft_com.serialization.2003.02.DefaultDocumentElement.xsd 

$(ProjectOir)..\tempun..org.DeltaV.Session.xsd 



6.4.2 Database Services 

Database services are hosted by DvDatabaseServer.exe, they Include DataAccess and Download as 
shown in Error! Reference source not found.. 



void .open(lntsessionH) 
void.clGseO 
string J(ey {gdt} 
void .testFoiOpenO 
vold.testToiCrcsedO 
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void Open({ntse5sionH) 
voidClG6e() 

void&(ecutBQueiy(string query) 

void B(ecutsCommand(string command) 


Li5t<string> Jtems 


void Open(IDownb«Mes5a9eCallback, IntsessionH) 
void ClcseO 

voldAddltem(5trtng ItenPath) 
voidB<ecutBDavnr9^^f) 







.caller 



o 



Figure 57. Database Services 



6.4.2.1 DataAccess 

The DataAccess service provides a general query and connmand interface into the database. 

6.4.2.2 Download 

The Download service manages the download sequence. The service methods in Errorl Reference 
source not found, are illustrative of those required for download. Clients of this service must first call 
Addltem to add items to be downloaded before calling ExecuteDownload. 

ExecuteDownload is a service message instead of a service method. This means it executes 
asynchronously. As it runs this method uses the callback Interface (IDownloadMessageCallback) to 
provide the client with feedback. The client implements this Interface and it is passed into the download 
service on Open. 
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6.4.3 Servers 



Services are deployed in servers, for example the database server (DvDatabaseServer.exe) the runtime 
. server (DvRuntimeServer.exe) and the historian server (DvHistorlanServer.exe). 

Each server contains an Indigo port identified by a unique URI. When the server is started it registers its 
URI with the local DeltaV discovery service. As client applications come up they ask the discovery service 
for the URI of whichever servers they need. They can then establish an Indigo channel connecting them 
to the server port. Once connected the client application can request a specific service interface from the 
server. 

6.4.4 Service Clients 

Error! Reference source not found, shows a typical client application connecting to the database and 
runtime servers. The client references the proxy assemblies for the services it intends to use from these 

servers. 




Figure 58. Service Client 

The first service the client uses will be the Session service, on which it will call Login. The client must do 
this for each server it intends to use. In Error! Reference source not found, the client holds session 
handles for the database and runtime servers. 

After calling Login the client can open other services and use them. Some services will require a callback 
interface on Open, for example the Download service. For download the client must implement the 
callback interface as defined in the service proxy and pass itself as the target of the callback on 
connecting to the service. 

The pseudo code below indicates the sequence of events. 



class DatabaseTest : IDownloadClient 
{ 

[STAThread] 

static void Main(stringD args) 
{ 

DatabaseTest test - new DatabaseTestQ; 
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// Open Ihe indigo service environment 

ServiceEnvironment se = ServiceEnvlronment.Load(); 

ServiceManager manager = se[typeof(ServiceManager)] as ServiceManager; 

se.OpenQ; 

// Create a port for callbacks 

Uri portUri - new Uri('soap.tcp://localhost/Database/"): 

Port port = new Port{portUri); 

// Get the URI of the database server 

Uri serviceUri = new Uri("soap.tcp://localhost:46001/Database/'); 

// Get the session service from the database server and login 
ISessionChannet session; 

session^ (ISesslonChannel)manager.CreateChannel(typeof(ISesstonChannet), serviceUri. test); 
int sessionH; 

session.LoginCBiir, "DalabaseTesf, out sessionH); 

// Get the data access service from the database server and open it and execute a query 
IDataAccessChannel dataAocess; 

dataAccess = (iDataAccessChannel)manager.CreateChannel(typeof(lDataAccessChannel), serviceUri. test); 

dataAccess.Open(sessionH); 

dataAccess.ExecuteQueryCSite.Modules"); 

// Close the open services and logout, or just logout 
session.LogoutQ; 

} 

// IDownioadClient 

public void SendMessage(IDownloadChannei sender, string message) 
Console.WriteLine(message); 

} 

} 



6.5 Proof of Concept 

In order to prove the goals for isolation have been met the following tests will be run 

• Layer process graphics onto Ovation, this requires Ovation to provide an implementation of the 
runtime service and a browser plug-in. 

• Run process graphics on Provox 

• Run the browser on OS file system 



6.6 Topologies 

The following Topologies will be supported 

1- Single stand-alone laptops 

2- Small Systems 
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3- Large Systems 

4- Zones 

5- Remote Clients 

6- Browsers 

6.7 Key Technologies 

The following technologies will be leveraged: 

1- Existing DeltaV System 

a. Runtime 

b. Database 

c. Control 

d. Security and Session 

e. Alarms and Events 

2- Longhom 

a. Indigo 

b. Avalon 

3- Compiler 

a. Whidbey 

4- Simulation 

a. High Fidelity Models 

b. FIR Technology 

5- Expert 

a. CUPS 

6.8 Versioning 

Services are registered on each node. The services register as the node boots and servers are started. 
Services fall into three categories: 

1- Services where there is 1 service in the system. 

2- Services that exist on every node. 

3- Services that exist on nodes if they are configured and licensed. 

Here are things that we can do to services: 
1- Extend the interface 
2^ Version the interface 

3- Rebuild/recompile the implementation for a new compiler and/or OS 
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4- Recompile the interface with a new compiler (new OS) 

Services need to be versioned. We version services so that we can maintain upward and downward 
compatibility. 

Clients see the following information: 

1- preferences 

2- licenses 

3- version information 

6.9 Deployment 

1- Clients can support multiple versions of services. 

2- Services can support multiple versions to clients. 

3- A version number will be included in the XML exchange when the service is located. 
4- 

6.10 Session 

6.11 Security 

6.12 Globalization and Localization 

6.13 Usability Guidelines 

The configuration Framework and subsequent applications developed should have a look / feel modeled 
after Visual Studio and Windows Explorer 
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7 Project Architecture 



7.1 Overview 

The topics In this document have, up to this point, discussed the newer functionality of Starburn and the 
frameworks, patterns, and techniques that will be used to both incorporate that functionality and build a 
scalable high performance set of applications and services. This chapter moves on to address the details 
required to build this project with a large team spread across several development sites. It discusses in 
detail structure of the development environment, software configuration management and versioning, 
team organization, and deployment. The chapter is organized into the following sections: 

1- Concepts - the main concepts needed to understand the Project Architecture. 

2- Software Configuration Management and Version Control - this section describes concepts, 
development process, and integrated software configuration management from the point of view 
of our services approach. 

3- Dependency iVIanagement - this section introduces a dependency model, which includes a 
categorization of dependencies between components, and a model for managing these 
dependencies. 

4- Development Environment and Deployment - completes the description of the development 
environment to include details such as how we build, transfer builds, and deploy software. 

5- Testing - discusses the approach for testing services, applications, and versioning. 

6- Project Manager Model — discusses the organizational principles of architecture-centric 
development, various project management views including the role of the architecture team, and 
the organization of teams around the services and applications that have been defined. 

7.2 Concepts 

The discussions presented so far in this document describe a Technical Architecture and an Application 
Architecture organized along the boundaries of services and functional groupings'*^. Functional groupings 
can be as small as a something like a diagram control or drag and drop or as large as entire application 
such as Process Graphics. As presented earlier in this document, we have learned how to develop major 
new functionality concurrently and iteratively - we know how to build and release using object-oriented 
technology. We have also become very good at testing and releasing very robust, high quality software. 
What has eluded us, however, is the ability to version software artifacts of anything smaller than the 
whole system . The architectures described here address this and several other issues. From a Project 
Architecture point of view the principles to support this architecture are: 

1- Services and functional groupings (i.e. software artifacts) are the basis of the Starbum approach. 
Project plans, builds, team structures, organizational boundaries, and task assignments 
recognize these service and functional grouping boundaries. 

2- Each functional software artifact and its spiecificatlons is owned by some group. Analysis, design, 
coding, and deliverables recognize these software artifact boundaries. 

3- The ownership concept is supported and strengthened by strict accessibility constraints 
throughout the development cycle. If an application needs to use an artifact that artifact must be 
made available through an explicit interface. 

4- Autonomous development requires the reduction of surface area across the lifecycle between 
artifacts. Dependencies between artifacts must be carefully managed. 



Services and functional groupings are sometimes referred to as 'software artifacts* in this document. 

This isn't completely true - we have always been able to release a small set of system independent features. 
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5- Deliverables are organized along the boundaries of services, functional groupings, and 
applications. 

6- Versloning is at the software artifact level/^ 

7- It must be possible to develop each service, functional grouping, and application with minimal 
waits from other parts of the system. This implies that it must be possible to add new functionality 
in parallel (note - we have done an outstanding job of this in DeltaV)^®. 

8* It must be possible to build and release new versions of services, functional groupings, and 
applications without completely re-testing the entire system. In cases where the changes are 
pervasive, it must be possible to regression test all interfaces and functional groupings. 

7.3 Software Configuration Management and Version Control 

Software Configuration Management and Version Control are critical in being able to build and deploy 
software into the field. In order to version software artifacts some knowledge of the dependencies 
between artifacts must be known. Two classifications of dependency must be known 

1- detailed dependency list - all software artifacts that a particular software artifact depends on 

2- versioned dependency list - version 'x-y-z' of software artifact 'aaa* depends on these versions of 
these software artifacts 

There is yet another level of complexity - DeltaV has both distributed components as well as layered 
components. As the development team knows, the existing core DeltaV system is strongly reuse based - 
there are no plans [and few justifiable reasons] to change this. This does lead, however, to a hierarchy of 
dependencies that must be understood, documented, and verifiable. For each version of software artifact 
that is released to the field it must be possible to document the set of dependencies as well as the known 
set of versions for all of those dependencies that the software artifact were tested and verified against. 
While the software configuration management software must be able to manage the versions of all of the 
core DeltaV System as well as all of the services, functional groupings, and applications built on top of the 
core, another mechanism is required to track dependencies of released software - this is referred to as 
'Dependency Management*. Dependency Management is covered in a later section in this chapter*®. 

So what about software configuration management? As we have always done SCM will be used to store 
and track source code. What is more complex is how the build procedures will change to accommodate 
both distributed development and versioning. The development environment and deployment is covered 
later In this document. 

7.3.1 Software Configuration Management 

Software configuration management is well known to the DeltaV team*^. We have addressed large scale 
development and releases through a combination of labeling, branching/pinning, and development 
procedures. The use of SourceSafe has been integrated with the IDE for many releases. Building 
versions of DeltaV has amounted to pulling a complete copy of source code from a specific branch each 
night, running the build procedures, localization routines, generating install images, and transferring the 
whole set to a file server. We do not propose that this procedure change for the core DeltaV 
infrastructure. 



The first question we ask customers who call up with a problem is "What version is your system?" With the 
additional flexibility of versioning at the artifact level and large numbers of artifacts being present in the system, the 
answer will not be as simple as it used to be. We will need to provide an application enabling both customers and 
our support staff to easily view and understand the version information associated with all their artifacts. 

Faking and simulating components and interfaces that are not yet available is a technique that has worked well to 
enable parallel development. 

A database will need to be created to support Dependency Management 
*^ At this point we are not actively pursuing a replacement for SourceSafe. I would like to see what features are 
available as part of the next version of Whidbey. 
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We do, however, plan to make significant enhancennents to both SCM as well as the build procedures to 
support multi-site development and versioning. For starters, different SS databases will be used to 
manage services, applications, and other software artifacts that can be independently versioned. To 
make source code integration easier to manage separate databases will also be used for Austin, 
Leicester . Manila, and Pittsburg. 

To address versioning the build system will be able to build specific versions of services, software 
artifacts, and applications. This will be achieved using a combination of a database for tracking 
dependencies and procedures for pulling the right bits out of source. To build install images it will be 
necessary to combine these version builds with a "golden" disk repository to fully assemble the complete 
set of deliverables. This ad-hoc combination of SCM, dependency database, and golden disk repository 
is required to fully support the deployment requirements set forth in this document. 

At this point at least a couple of questions should be in everyone's minds: 

1- Where is the "golden" copy of each software artifact stored? As far as source code developed by 
the developer is concerned, the software is stored in SCM. Code generated by the tools, e.g. 
Schemas and Proxy's, are stored on the file system. The golden copies of all deliverables 
released to the field are stored in the file system. 

2- Which level of version granularity will be known to the tools? Versions of files developed by 
developers are obviously always stored in the SCM. Versions of assemblies to be included in 
specific software deployments must be managed by the dependency management system. 

A point that deserves repeating is this - the versionable items in the OeltaV System are services, 
applications, and supporting software artifacts that can be compiled into assemblies or exe's. 

Based on this discussion the SCM strategy will be: 

1- The SCM system can be used for check-in and check-out. Within the SCM system software 
services, software artifacts, and applications are grouped by their respective function. 

2- Each version of each individual software service, software artifact, and application as well as the 
dependencies between them is managed outside of the SCM system. A dependency 
management system is used to track version dependencies. A file system is used to store alt of 
the versions. Strict guidelines are used to govern how a physical file system directory structure is 
to be used store all of the released versions. 

3- The SCM system is organized around the DeltaV Core Infrastructure, services, software artifacts, 
and applications. 

4- Each software development site has Its own SCM System^®. 

5- The Austin build procedures will be able to perform a complete build of core infrastructure, 
services, software artifacts, and applications. A complete build includes all the steps necessary 
to build install Images. 

6- The Austin build procedures will be able to perform version builds. Version builds include the 
steps necessary to build install images for minor releases, service pack releases, and hot fixes. 

7.3.2 Versioning 

New applications using updated library components run concurrently with existing applications using older 
versions of library components. This is made possible by using the versioning capabilities of .NET 
modules. 



The exception here is that database code will continue to be integrated into the core Delta V infrastructure 
Consistent software and procedures across sites but, different content. 
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This is especially critical in deploying application and core service versions independently. When a new 
version of a service is installed it comes with a new version of the proxy to be used by the applications. 
Unless the newer version of an application is installed it will continue to use the older version of the 
service proxy. Thus both versions of the service proxy may need to reside on the client machine at the 
same time. 

7,3.3 SCM System Layout 

The following sections describe the layout of the configuration management system. 
7.3.3.1 Core Infrastructure 



$\DeltaV 

\Code 

\bln (this arrangement is still under construction) 
\DvRundfneServer 

.exe, .dll, .manifest, .deploy 

\v1.1 

.exe, .dll. .deploy 
\ 

\Starbum (interop) 

\DvDatabaseServer 
\ConfigXM 

Mest 

\Docs 

VOvRuntimeSenrer 

\Security 

\Session 

\DdtaAccess 

Mest 

\Docs 



7.3.3.2 Austin 



$\Starbum 
\Core 

\Mainline 

\Session 

\Proxy 
Mest 
\DvDatabaseServer 
\DataAccess 
\Proxy 
\Download 
\Proxy 

Mest 
\Docs 
\DvRuntimeSen^er 

\DataAccess 
\Proxy 
\Session 

\Proxy 
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\Tesl 
\Docs 
\DvCorUb 
\Doc 

\BrowserFramework 
VMainline 
Wl.l 

\ClientModel 

VMainline 

\Model 

\Schema 
VBrowser 

\v1.1 

\Model 

\Schema 

\Browser 
\DvControl Studio 
VMainline 
Vv1.1 



7.3.3.3 Manila 



$VStarbum 

VDvProcessGraphicEditor 
VMainline 

VBrowser 

Vvl.1 

VBrowser 
VDvProcessModuleEdltor 
VMainline 
Vv1.1 



7.4 Dependency Management 

Simply stated. Dependency Managennent is the set of concepts and tools that allow proper management 
of dependencies in a service based system. Dependency management includes for each project: 

1- The definition of a dependency model which includes the Identification of possible categories of 
dependencies between services, software artifacts, and applications. The model also includes 
how the project intends to handle those dependencies. 

2- The development of appropriate tools to manage these dependencies. 
7.4.1 Dependency Model 

The dependency model is an explicit description of the dependency categories between services and 
artifacts and how a project will deal with these dependencies. An explicit description of what is visible 
outside an interface or software artifact is defined. Functionality is made visible by explicitly defining it as 
such. The approach we are using to version software uses an explicit interface model. As an example: 

1- A software component B "exposes" software feature V by designating it as available for use by 
another software component through an Interface. 

2- A software component A uses software feature "xT from B by referencing A in its project. 
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3- Software component A then uses software feature "x". 

The two main features in this approach are to support the reduction of surface area between software 
components and to support the management of unavoidable dependencies. The features are enforced 
by the notion of strict enforcement of ownership of software artitects. This in turn leads to better support 
of change management which ultimately enhances our ability to develop and release Independently. 

The dependencies in a project can be summarized as follows: 

1- Use an Interface : This is a runtime method invocation dependency — in order to invoke a 
method on a service at runtime a software artifact, service, or application must know the proxy, 
data types, and error definitions of the thing being Invoked. 

2- Extend an Interface : This is a development time interface dependency - in order to use a 
functional grouping in the system a component must implement an interface defined by another 
component. For example, in order to support Browse functionality Process Graphics must 
implement the Browse Interface. 

3- Reuse code : This is an internal design dependency - a number of software items may be re- 
used in order to Implement some set of functionality. In these cases the decision is being made 
to reuse code instead of implementing the same functionality over and over. 



7.4.2 Developnnent Environment 

A given software artifact can be in several versions of DeltaV at the same time. To support this multiple 
versions of software will be available on the same system at the same time. How this handled for 
developers is different than how it done for released systems. For developers the *...\code\bin' directory 
will be partitioned to support versions. For release deployment the GAC will be used. 

The development environment is set up to allow developers to develop, debug, and unit test those parts 
of the system they are responsible for. By pulling enough source code the developers can also debug 
into and at times troubleshoot those parts of the system that they have dependencies on. A complexity 
that is introduced in this development is how to unit test backward versions. To do so developers also 
need multiple versions of services and other software artifacts where they have version dependencies. 

As was discussed earlier, from a SCM point of view, as a general rule a change in a dependent 
component must be explicit. For example, if a software grouping or application is changed the 
dependency list must be updated to enforce that the new version of the service will be used. When the 
application is deployed the services it is dependent on must also be deployed. For developers this 
means that the developers need to have alt of the dependent versions of assemblies duplicated in the 
different build directories. So how do developers deal with this? 

The developer environment will be organized as a directory tree structure. As is currently done with 
DeltaV, the SCM system layout mirrors the file structure - this makes it easy for developers to locate 
projects, checkin/out files, etc. What is different from toda/s structure is the location that interfaces, 
assemblies, applications, and software artifacts that can be versioned compile into. The approach, simply 
stated. Is to copy all of the referenced assemblies and supporting files for each project into versioned 
directories. Although this leads to enormous amount of duplication the approach assures that developers 
will have the correct versions to work with when they are developing, unit testing, and debugging versions 
of items. So where is the master copy of all of all of those versions? 

In order to support developers we are proposing that the build system maintain 

1> Nightly builds as is done today. 

2- A nightly build structure for versioned items that includes the last 21 builds. 

3- A release build structure as is done today. 

4- Extensions to the release build structure that includes every released version ever released. This 
structure must be kept around for-ever. 
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-Developers will be able to pull current as well as previous versions of services, artifacts, and applications 
for development, unit testing, and trouble-shooting field problems. 

The layout of the "bin" directory is shown below. 
\bin 

\DeltaV.CIientModel 
\v1 

dlentmodeLdll 
\v1.1 

dlentmodel.dll 
\DeltaV.BrowserFramwork 
\v1 

browserframework.dll 
\v1.1 

browserframework.dll 
W1.2 

browserframework.dil 
\DeltaV.CIientModel.Browser 
\v1 

clientmodelbrowserdatasource.dll 
\DeltaV.Explorer 
\v1 
exp.exe 
\DeltaV.ExplorerPackages 
\v1 

moduIebrowser.dll 
attributebrowser.dll 



7.4.3 Build Environment 

The build environment has to address the needs of major releases, minor releases, service packs, and 
hot fixes. In addition, the build environment has to be able to build and track versions. This section first 
discusses versions and then discusses a new tool, the Component Dependency Manager. 

7.4.3.1 Versions 

7.4.3. 1 . 1 Major Releases 

Major number releases consist of a complete set of core system functionality together with a complete set 
of services and applications. In many cases the release will include multiple versions of services for 
backward compatibility. Applications should represent the applications at the major number that is being 
released. Major releases are packaged together with a complete set of user documentation, upgrade 
utilities, installation tools, and so forth. Major releases are fully regression tested. These releases 
correspond closely with today's DeltaV releases with one significant difference - major releases also 
need to be backward compatibility tested. 

7.4.3.1.2 Minor Releases 

Minor number releases fall into two camps: 

1- The core Infrastructure is updated to address field issues, robustness issues, and performance 
issues. No new functionality is introduced. 
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2- New functionality that does not require additional core infrastructure support. For example the a 
decision could be made to release abnormal situation prevention features that do not require 
communication, lO or controller support. Another example could be the addition of new Process 
Graphics support. 

In case 1 above the versionable items in the system are not changing so no dependency lists are 
affected. In case 2 some combination of services, artifacts, and applications may all be affected. The 
various dependencies lists would all need to be updated. 

7.4.3.1.3 Service Packs 

Service packs are designed to collect together hot fixes and minor functional releases. The intent of 
service packs is to make it easy for customers and our own customer support infrastructure to install 
collections of updates that have been tested and validated as a complete set. 

In the case of service packs collections of versions will need to be brought together so that a mixed 
system continues to function correctly. 

7.4.3.1.4 Hot Fixes 

Hot fixes are designed to address a specific issue or a set of related issues. These hot fixes are released 
as individual repairs into the field. When a hot fix affects the version dependencies of some component 
then the dependent item will also need to be included in the hot fix. The dependency management 
system should include this information. 

7.4.3.2 Dependency Manager 

The dependency model requires a tool to support it - the tool is referred to as the Dependency Manager. 
The Dependency Manager (DM) tool needs to be able to manage, across the development cycle, the 
versions of the system, the versions of the interfaces/artifacts/applications, and the dependencies 
between them. To manage the builds and versions the DM uses a dependency list. The dependency list 
appears as shown in the table below: 



Component 


Build Item 


Version 


Dependency List 


DeltaV.CIientModel 


ClientModei.dll 


VI .0 





















The DM should be able to navigate the dependency list of each item in the dependency list. The 
knowledge of this should be contained in a dependency database. Based on the information in the 
dependency list the DM should be able to navigate the entire major version hierarchy. It should be able 
to load the DM database and generate scripts for builds. 

The DM needs to have the following capabilities: 

1- Determine dependency consistency. No circular invocations are allowed. 

2- Starting from dependency lists, generate the appropriate scripts for the build process. These 
scripts are then used to build the various versions as outlined earlier in this document. 

3- Open a given dependency list for a given component and browse the dependencies, check for 
consistencies, etc. 

4- For each Component in the DM database, provide the list of available versions. 

5- Provide revision history on the components in the DM database. 
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Given that we figure out how to develop the DM database and generate build scripts, there is still one 
dimension to the problem. The actual build environment itself must be known. Given the direction stated 
in this document there will be scenarios where versioned items are originating from different versions of 
compilers. The strategy that will be stated here is this: 

1- The build tools can be upgraded to the next major version when DeltaV rev's a major version 
number. 

2- All minor builds off the DeltaV major version will use the major versions MS and other compilers. 

There is still one more major consideration - the target system. Again the working practice here will be 
that major operating system revisions will be accommodated with DeltaV major version numbers. 



IVe need a couple of things here 

U To develop example scripts that show how to fetch from SS and build versions, 

2- To put together a SQL database to host the DM database and support the script building as 
detailed in these sections. 



7.5 Testing 

All software developed as part of the Starburn Program comes complete with unit testing scripts. These 
scripts fully test ail interfaces. These tests need to also be developed so that they can be combined and 
used for regression testing. 

7.5.1 Unit Testing 

There will be a full unit testing of all interfaces. The core services will be tested as will the supporting 
interface layers beneath the application components. Other strategies will be developed for testing the Ul 
itself. 

Unit tests must test the interface contract and semantics. It Is important to provide adequate testing of 
the server schema and the server Interface. 

There will be a test framework. All tests will be run nightly. Developers are responsibly for submitting a 
test for any code they write. 

7.5.2 Regression Testing 

There will be a full regression testing of all interfaces and all supported versions as defined in the 
dependency database. The core services will be regression tested as will the supporting interface layers 
beneath the application components. Other strategies will be developed for testing the Ul itself. 

Regression tests must test the interface contract and semantics. It is important to provide adequate 
testing of the server schema and the server interface. 
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7.6 Project Documentation 

The project documentation is primarity contained in two places: 

1- In SS under $/Starburn 

2- In Select. The organization of Select DataStores and models is show in the table below. 





DATASTORE LOCATION 


Model Stereotype 


Austin (Aus) 


Manila (Mnl) 


Leicester (Lei) 


Technical Architecture 

Patterns and helpers that 
apply across the board, 
throughout config or 
throughout runtime. 


SbAusTechArch * 
CommonArchitecture 
ConflgArchitecture 
RuntlmeArchitecture 






Solution 

A particular area of 
functionality deliverable to 
the user, such as Process 
Graphics or Expert 
Modules. 


SbA usSofutions 
ConfigurationWorkSpace 
RuntimeWorkspace 
ProcessModutesRuntlme 


SbMnfSolutions 

ExpertModulesConfig 

ExpertModulesRuntime 

Process ModulesConflg 

ProcessGraphicsConfig 

ProcessGraphicsRuntime 


SbLeiSotutions 
ContinuouslHistorian 


infrastructure 
The Client Model and 
Server layers of the 
system. 


SbA usinfrastrueture 

ClientModel 

ConfigurationServer 




SbLeHnfrastructure 
Generic Schema 
ServerSchema 
Model! mplementation 
XM Interface l^yer 


Component 

A component reusable in 
multiple contexts, such as 
the Diagram Control and 
Structured Text Edit 
Control. 


SbAusComponents 


SbMnlComponents 
DIagramControl 


LeiComponents 
TextEditControl 


Frameworit. 

A set of classes firom 

which Component or 

Solution developers can 

inherit. 


SbAusFramework * 
ConflgurationViewFramewoni 




SbLeiFramewrorks 
GenericServerModel 



Items in bold Italics are DataStores. Each has a list of contained models with who Is 
responsible for them in brackets. Datastores martced with an asterisk are transmitted 
between sites for external referendng. 

Component Interfeces are published between sites using Select Component Manager. 



Leicester Xms and Dbs layer are assumed to be in a sepatate data store and are not 
included here. 
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7.7 Project Manager Model 

The Delta V System as described here is a combination of the traditional software organization as well as 
a new service-oriented organization. The traditional organization is structured around technical expertise. 
This organization typically has control experts, controller experts, lO experts, client-writer experts, 
database experts, etc. Functional experience Is often separate from application development. This style 
of organization is supported along the lines of deep experience, long learning curves, etc. Many of the 
principles that support working this way have not gone away - for example control expertise takes many 
years to develop and is best left with the few folks that completely understand it. 

On the other hand service-oriented development Is organized around units of delivery. In this model 
every service, software functional grouping, and application is owned In-total by a specific team. The 
whole model is optimized for minimal interruption, minimal external control and checks, and minimal 
waiting on other teams. Such an organization requires that all developers have some level of knowledge 
about the overall system being built. To keep these functional groups developing there must be a pool of 
expertise that can deal with specific problems outside of the specific teams functional expertise. Taken to 
the extreme it should be possible to transfer development activities from one team to another - even if the 
team is geographically separated from the other teams. 

Shown below are runtime and configuration models that will be developed as part of the Starburn project. 
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Figure 59. Conflguration Models 
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Figure 60. Runtime Models 



The diagrams above continue to highlight another important concept presented in this document: the 
differences between Solution/Application iV^odels and Technical Models. The stereotyping for models fall 
into the following categories: 

a. Technical Architecture: utility components and patterns that cross layers. There are 
several instances of these including Common. Runtime and Configuration. 

b. Infrastructure: the middle layers, which largely facilitate communication and decouple 
client/server. Instances of this would be e.g. XM, Generic Model, Client Interface, etc. 

c. Framework: the class framework and utility components for a particular layer. Instances 
would be e.g. Client Model Framework. Ui Framework. 

d. Solution/Application: the collection of components that make up an application. 
Instances would be e.g. Process Graphics, Process Modules. The runtime and 
configuration parts of each of these would be separate models as ownership is likely to 
be in different teams/sites, it is possible that there would be some things shared between 
configuration and runtime. In that case options would be to put the common things in a 
separate model or in one of configuration/runtime. 

e. Component: a model dedicated to a particular component. 

discuss design repositories to some extent here 
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8 Development Practices 



As the saying goes, there are two ways a project can fail, by not following a development process and 
following a development process^. DeltaV has always successfully endorsed a strong development 
process and will continue to do so. However, we need to extend the process to support the concepts 
described in this document for versioning and multi-site development. 



Our primary objectives in making changes to the development process are to: 

• Accommodate a new and rapidly expanding development group in Manila and have this group 
contribute productively to the Starburn program. 

• Enable collaboration with the development group In Pittsburg. 

• Enable the four development sites and the project teams within them to progress parts of the 
Starburn development in parallel. 

• Support the flexibility in versioning and deployment described In the Project Architecture section, 
thus enabling frequent enhancement of the application layers of the system upon a very stable 
core. 

• Ease the burden of producing and testing localized versions of the software and enable much 
closer to simultaneous release of base language and localized versions. 

• Enhance the quality of our designs. 

• Improve the testability of our software. 

• <Mark, Td like to improve the traceabllity of our software but I don't know if you'd want to put that 
here.> 



Two enhancements to our process in particular stem from advances in software development theory and 
practice that have emerged since the inception of DeltaV development in 1995. These are 

• The introduction of Component and Service Based Development (CBD). This can also be 
considered an Interface Centric approach to development. 

• A conscious focus on Technical Architecture and the separation of it from the Solutions or 
Applications that provide particular features to the user. Technical Architecture provides common 
services to the Applications. 



Other significant changes are: 

• Clear separation of a core system from the software that layers upon it, not only In terms of 
software artifacts but also in frequency of revision. 

• Greater use of automation both in testing, building and documenting the system. 



It is worth mentioned some things that we will retain from our previous practices. 

• Incremental development, with early increments emphasizing research and prototyping whilst 
later increments emphasize the structured and formal addition of features to the system. Early 
increments cut a path through the system from top to bottom with bare bones functionality to 
establish the architecture and patterns. Subsequent increments broaden the feature set. 



Francois Deverdiere 
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• The major phases of development we have used before within increments will remain in place, 
namely Requirements, Analysis, Design, Implementation, Validation and Verification. 

• The Iterative approach to development will continue, particularly in the development of non-core 
parts of the system, so that as before the above phases will, and should run in parallel, with the 
balance of activity typically shifting towards the "later" phases over time. 

• The Object Oriented approach that has served us well will continue to be used within 
components. 

• We will continue to use Select and UML to produce diagrammatic representations of our designs, 
in Starbum this practice will become more common across the whole development team. 

• Direction and Change statements. Use cases and Concept Documents will continue to be the 
driving forces of requirements. 

• We will continue to strive for the re-use of software artifacts wherever possible. However, we will 
need to strike a balance between re-use and autonomy of components so as not to create 
unmanageable dependencies. Part of the continue effort on re-use will see us adopting a 
"pattern" mentality, where developers identify and re-use common patterns in both design and 
implementation. 



Although it is not strictly a process change, it is worth stating here that there will be an increased 
emphasis on the use of XML throughout the system. XML will form the primary content of many of our 
interfaces. This keeps the interfaces light in terms of the methods supported, whilst allowing them to be 
rich in content. The meta-formats of such XML will be defined as part of our design, through schemes (of 
our own making and also written in XML, but not XSD). Such schemes will allow the collaborators on 
each side of an interface to validate and interpret the content of messages. XML "blobs" will be used to 
describe the content of certain items stored in the database. XML will also be used to enable much of our 
software to be data driven. A particular advantage of using XML in interfaces is that it will better facilitate 
the capture of data passing through interfaces for the purpose of automated regression testing and 
diagnostics. 



The remainder of this section describes the process changes in more detail and then gives a brief outline 
of the major phases of development and the artifacts used in them. 



At the end of the section are some examples of the analysis and design diagrams we will use. These are 
samples taken from Select that do not form part of the actual Starbum design. 

8.1 Component and Service Based Development 



There is a vanety of opinion in the literature concerning Component Base Development. We choose to 
take a pragmatic and readily understandable position. We consider a Component to be an independently 
deployable unit of functionality, such as a C# assembly, or an executable program. 



A component provides Services to other components through well defined Interfaces that provide a 
contract between the component and the things that use it 



144 



There is a specific design activity in which we identify components and the services they will provide. This 
can be approached both top down and bottom up. In a top down approach we first identify candidate 
components that are appropriate to handle particular areas of functionality. The components are then 
fleshed out by modeling their interiors. In a bottom up approach, first a class model is constructed and 
then classes are clustered to form components. In practice a combination of the two approaches is likely 
to be used. Also the design and implementation will be iterated to reach a final, well balanced solution. 



Components should be designed to be internally cohesive and externally loosely coupled. There should 
be no circular dependencies between them. 



Some components provide common services to a wide variety of applications within the system, whilst 
others are more application specific. 



An application is typically achieved through the use of many components collaborating to achieve the 
desired functionality. 



Within components we will continue to use object oriented techniques and our implementations will 
remain object oriented through use of the C# language. 



We will continue to use the Select Component Architect OOA/D tool to document Component Based 
designs, using the UML notation. UML "packages" are used to depict components within the designs. 
Training in this approach is provided by Select Business Solutions. A UML/Select design guideline will aid 
the developers in producing good designs. The Select automated Reviewer tool will also be used to help 
ensure correctness and consistency. Each site will be provided with a copy of this tool, which can be run 
ad hoc, or as part of the regular build process. 



In some cases it may be possible to generate code fi'om the designs, using the Select C# synchronization 
tool. Each site will be provided with a copy of this tool, which again can be run ad hoc or as part of the 
build process. 



8.1 .1 Layering and Stereotyping 



Component based designs will make use of layering (tiering) and UML stereotypes to help guide 
developers in their designs and to provide additional levels of organization and structure. A multi-tiered 
architecture for the configuration system has already been established during the early increments of 
Starburn. 

8. 1 .2 Component Management 
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Having identified components and their inteifaces we need to publish information about them to the 
development teams so that parallel development can proceed with confidence that the Interfaces are 
agreed and will be supported. The Select Component Manager (SCM) provides a means to publish 
information about components. It supports the Supply, Manage and Consume philosophy (SMAC). 
Specifications of components can be published from Select Component Architect into SCM. Other 
designs in SCA can use these specifications. Component implementations can later be added to the 
SCM repository. 



8.2 Architecture Versus Solutions 



The Starburn approach more formally recognizes and clarifies what is meant by "Architecture". There is a 
separation of concerns between Architecture and "Solutions" or applications. Again this is used to guide 
our designs and development. 



Our development will continue to be driven by Use Cases, both for Solutions that have user interfaces 
and those that do not. As application developers proceed with their designs they will identify Use Cases 
that apply specifically to their application; these are known as Solution Use Cases. They will also 
encounter use cases that should not be application specific but should be common across all. or many 
applications. These will become identified as Architectural Use Cases and will be modeled separately 
from Solution specific use cases. Features such as checking access rights, exception handling, producing 
pop-up menus, analyzing reference paths and accessing data sources would all be examples of 
Architectural Use Cases. 



Specific teams and individual developers will be devoted to developing software that will satisfy the needs 
of the architectural use cases. 



The architecture manifests itself as: 

• Components that provide common services 

• Components that provide helper functions 

• Class frameworks from which applications can inherit 

• Design and coding pattems that provide guidance as to how developers should best make use of 
the architectural software. 



8.3 Requirements 



<Mark. problems I have had with the current artifacts are the fragmented nature of the information, the 
difficulty of keeping the different artifacts in sync and the lack of clarity over the role within our process of 
the requirements in each artifact. I would like to more formally define exactly where we state our 
requirements, such that they can be checked off a) by developers and reviewers to ensure the 
requirements have been catered for in the design, b) by developers when they are writing test scripts, and 
c) by the system testers when they are verifying the requirements. You have actually gone some way 
towards this in your text below. 
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Perhaps this is a leveled set of information, with the Dir/Change stats providing the first level, concept 
document providing the second level and Use Cases providing the third level. I am thinl<ing that the Use 
Cases could be the formal exposition of requirements, though we would have to be sure and document 
the alternative paths adequately (Jenny has worked on a Use Case template addresses this). We also 
need to cater for non-feature based requirements such as performance (could be included in the business 
rules you identified. 



Aside: As you probably gathered I like the idea of a requirements database, which can give a lot of power 
to organize and understand the requirements, structure them hierarchically, track their status, maintain 
unique Ids, keep an audit trail, enhance traceabllity, avoid duplication, and enable different views onto the 
requirements info set. Of course this has its problems, particularly in terms of integration with graphical 
information, though this is not insurmountable. 1 don't think we could do it right now but it is a gleam in my 
eye for when I get further down the road here.> 



The following artifacts are produced during the requirements phase for each major feature set to be 
added to the system. (From a project management point each major feature set gives rise to a Project): 

1- A direction statement. The marketing direction statement contains a feature list, typically a few 
lines per feature, describing the key aspects of the system. The features are numbered and will 
act as a check list for both developers and system testers later in the project. Marketing and 
Technology collaborate to establish the content of the direction statement. 

2- A concept document. The concept document acts as a guiding light for the ensuing 
development. It includes a rough scope of the system, a description of the main features, 
typically containing overview diagrams such as network topologies and software layer diagrams, 
a summary of the key requirements and key technologies (if appropriate), a description of the 
system's main external interfaces, and in some cases a set of models describing the key features 
of the system. 

The precise scope of the content of a concept document cannot be prescribed for all projects 
because all will have different characteristics. However, this document is expected to represent 
the accumulated wisdom on the topic in question and to cover any angles that might come into 
question during the development. A few examples of the content are why we are doing this, who 
the target users are, key user visible objects, how downloads need to work and migration from 
earlier releases. 

The key requirements are identified in the concept document by continuous numbered bullets that 
run throughout the document independently from the section numbering. These key 
requirements again act as a check list for both developers and testers. 

3- An initial user-interface prototype, where appropriate. This is often the best way to quickly 
focus the requirements gathering activities while gathering feedback from users, marketing, etc. 

4- An initial set of business rules. This is the set of requirements that the system must satisfy 
such as constraints upon item naming, and item values, inter-item referencing, performance, 
compatibility etc. Also included here are requirements concerning aspects of the system such as 
Version control and Security. 

This document persists and is expanded throughout the development cycle, eventually ending up 
as the definitive statement of the business rules that will govern constraints and validation to be 
applied in the database, the user interface and the runtime software. It acts as a check list for 
developers and testers, and a source of information for the documentation team. Extensions to 
the interface model should be specified <Mark, not sure what you meant by this>. 
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5- A test specification. An initial test specification that will be used for acceptance testing, based 
on the direction statement and concept document. 

The set of requirements deliverables will depend on the scope and complexity of the project. In some 
cases customer involvement is required - in many cases no direct customer involvement is provided until 
the requirements and concepts have been initially written, intellectual property identified and patented, 
and the 1^* increment of development completed. Based on the initial customer feedback the 
requirements may have to be adjusted. 

The requirements documents for a project will evolve as development increments progress between 
project initiation and the delivery of a release containing the components produced by the project. 

8.4 Analysis 

The following artifacts are produced during the analysis phase: 

1- User interface Use Case documents. In these documents a combination of user interface 
deliverables and activity drawings are developed. The activity drawings should be captured in 
Select. The use cases will document the normal paths through the software and also alternate 
paths, which may arise in error situations. 

2* System Use Case Documents. These documents contain use cases that involve no direct 
interaction with the user, such as how to handle an event such as an alarm within the control 
software. These use cases should again identify normal and alternate paths. 

3- Component diagrams. These diagrams use UML packages to identify components and how 
they are related. 

4- Class Diagrams. These may be started at this stage to describe the internals of components or 
as part of a bottom up approach to component identification. 

5- Use Case Diagrams will be used as the top level representation of use cases and the associated 
sequence and collaboration diagrams. 

6- Component and possibly Object Sequence Diagrams will be started at this stage. 

7- Collaboration diagrams. These diagrams show how Instances of classes or components work 
together to achieve a particular objective. They help to understand the problems and ensure that 
component, class and sequence diagrams are correct. They are usually intermediate artifacts that 
may be discarded. 

All the diagrams mentioned above are recorded in Select. 

8.5 Design 

The following are produced as part of the design phase: 

1- The Component Diagrams, Class Diagrams, Use Case Diagrams and Sequence Diagrams 

started during Analysis will all be refined and fleshed out at the design stage. 

2- State Diagrams, for example describing the life-cycles of objects, will be constructed. 
These are particularly relevant to runtime software. 

3. Deployment Diagrams. These diagrams show how components are deployed physically within 
the system. 

A' Detailed design document. The design document makes use of the detailed select diagrams 
summarized above. It describes in text the reasoning behind any difficult or contentious design 
choices and nuances of the design that may not be apparent from the diagrams. 
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5- Interface specifications. The interface specification describes the interfaces supplied by and 
required by each component. The specification includes test specifications for each interface, 
preconditions & postconditions, expected results, and expected state information. Parameters of 
the interfaces are detailed. In particular the formats of string parameters that pass Xml structures 
are specified. The details of the interfaces are recorded in Select Component Architect and 
published into Select Component Manager. 

6- Dependency specification. The dependency specification includes a defined dependency list 
and the list of interfaces and methods required. Each dependency may be illustrated by an inter- 
dependency sequence or collaboration diagram specifying the flow of the processing. 

7* Version dependency information. Using the dependency list and the Dependency Manager 
the developer should be able to summarize the version dependencies. Together with the project 
team the combinations of versions that will be supported should be able to be wori<ed out. 

8- Download and import/Export formats are defined at this stage. 



8.6 implendentation 

Implementation includes the following: 

1- The development of the feature set and supporting test scripts. Development will be carried out 
using Whidbey, the Longhorn version of Microsoft Visual Studio. 

2- Unit test scripts are written by the developers to cover both the normal and alternate paths of use 
cases and other documented requirements. The developers ensure that the software builds and 
the tests run successfully on their local machine before checking both code and test script back 
into SourceSafe. The Unit tests also act as regression tests. 

3- Coverage Analysis is carried out to ensure that all code written to implement the required 
functionality is exercised by the test scripts. 

4- Integration into the build. All new components that are checked into SourceSafe are incorporated 
into the daily build process and become available for use by other developers. 

5- Integration into the test harness. A test harness is provided for developers. This is used to run 
their tests locally and also to unit/regression tests. When new components are included in the 
build process the corresponding test scripts are included in the post-build test run. 

6- System testing. An independent System Test group develops and executes tests based on 
Direction Statements, Concept Documents and Use Case documents. 

7- Handoff to test team. Groups of software components are handed off to the System Test team 
when all requirements have been covered by the implementation, coverage analysis shows that 
all the software is being exercised by the test scripts and all the tests succeed. 



8.7 Validation and Verification 

Validation and verification occurs at multiple phases of the project: 

1- Analysis - developers hold reviews of functional specification, prototypes 

2- Design - developers hold reviews of models, designs 

3- Implementation - code and tests scripts are reviewed using walkthroughs or inspections. 

4- System Test team - the System Test team review their tests to ensure they will adequately 
validate the required feature set and system as a whole and execute these tests. 
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At each stage of reviews the various constraints should be discussed. 

All reviews are documented in review databases that are maintained at each site. 
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8.8 Sample Diagrams 



8.8.1 Component Diagram 



The following Figure is an example of a class diagram showing Components (as UML Packages) and the 
Interfaces they support. In this case the components are grouped into two layers. Components in the 
Process Control layer are used to sequence and co-ordinate the activities of the components in the 
Business Logic layer. 
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Figure 61 Component Diagram 
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8.8.2 Component Sequence Diagram 

Figure 62 is a sequence diagram showing a sequence of interactions between components. 




Figure 62 Component Sequence Diagram 



8.8.3 Use Case Diagram 



Figure 63 Is a Use Case diagram showing how external Actors (in this case users) interact with use cases 
and how use cases are related to each other. 
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8.8.4 Collaboration Diagram 

Figure 64 is a collaboration diagram showing how particular instances of objects and interfaces work 
together to achieve a specific objective. 




Figure 64 Collaboration Diagram 
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8.8.5 State Diagram 



Figure 65 is a state chart showing the life cycle of an order. 



Qrder 



DELETED 



Erroneous Entry/ 



send Order Accepted/ 
CenerBte tnv^ce No 




Figure 65 State Diagram 
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Process Graphics Editor I 
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1. Introduction 



1.1. Overview of the Process Graphics 

The overall Process Graphics Architecture comprise of Configuration and Runtime 
Components, which are supported by other subsystems such as Control, Communications, 
etc. The Configuration System is linked to the runtime through a supporting Runtime 
workspace and a set of pre-built files providing a set of known behaviors. 
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1.2. The Process Graphics Editor 

As part of the development program, this document describes the concept of the Process 
Graphics Editor which is one of the many graphical editors available in. Its goal is to identify 
and define the design Implementation for the set of features of the Process Graphics Editor 
which provides the configuration editor for the operator displays. 

This concept document defines the primar/ objects and functions of the Process Graphics in 
relation to the Workspace, Qient Model, Generic Diagram controls, etc. 

The Process Graphics Editor used In the scenarios makes use of a number of features. A 
snapshot of the editor is included below. 
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Figure 1 - Process Graphics Editor screen sitot. 



J.3, Definitions 

1.4. References 

1.5. Deliverables 
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2. Objectives 



The objective pf the Process Graphics Editor Is to provide a superior configuration editor for 
the operator display: 

1. The Process Graphics Editor runs on top of the Configuration Workspace. 

2. The Process Graphics Editor communicates with the Client l^odel in retrieving 
Operator Display data from remote database server. 

3. The Process Graphics Editor utilizes the Generic Diagram Control in drawing. 

4. Be able to provide a Display Editor view where user can create/modify operator 
display. 

5. Be able to provide a Dynamics Editor where user can create/modify dynamic 
functionality by use of sequential function blocks. 

6. Any static item can be turned into a dynamic Item. 

7. Be able to provide display elements. 

a. Shape Elements (Rectangle, Polygon, Cirde/Ellipse^ Line, Polylines, Path) 

b. Container elements 

I. Group 
il. SVG 
iii. Symbols 

c. Text Elements 

i. Text, Text path 

d. Reference Elements 

i. Image 

e. Other Elements 

i. Script 
il. PCDATA 
ill. description 

8. Be able to provide user controls on the display 

a. Button 

b. TextBox 

c. CheckBox 

d. ListBox 

e. Slider 

9. Be able to add behaviors to the display 

a. Action, Alert(attach a data mapping) 

b. Conditions (If, Switch) 

c. Element (Copy, Create, Move, Replace) 

d. Listener (register for an event and take action when the event arrives) 

e. LoadURL 

f. LoadXML 

g. Print Element 

10. Be able to bind inputs and outputs to different data sources 

a. Delta V Runtime 

b. DeltaV Historian 

c. OPC 

d. XML nie 

e. HTTP Link 

f . Alarm Services 

g. Event Services 

h. General Web Services 

j. Yukon Managed Runtime (ADO interface) 

11. Be able to perform the following actions while editing a display 

a. Copy, Paste, Cut, Delete nodes 
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b. Move to Back/Front 

c. Move One Forward/Backward 

12. Be able to perform the following actions while editing a dynamic behavior 

a. Create inputs and outputs 

b. Add function blocks 

c. Connect using wires 

d. Add an 10 binding to inputs 
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3. User Interface 



The Process Graphics Editor is composed of the following UI elements: 
3.1. Display Editor 
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Figure 2 - PGE UI Components 
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4. Object Model 

4.1. Design Diagrams 
4.1.1. PG Object Model 




Figure 3 - PG Object Model 
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4.1.2. PG Editor Forms & Controls 

All forms/views and controls are derived from Configuration Workspace 
connponents. 




Figure 4 - PGE Forms & Controls 
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4.1.3. 



PG Custom Collections & External references 



PG Custom Collections are derived from System.Collectlons.CdllectionBase to 
easily support .NET data bound controls. 




Figure 5 - PG Custom Collections & External references 
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4.1.4. Client Model 

The Display definition will be stored in the database as an xml, wherein the details of the 
display are stored as an XML blob. 



Listed below is an example of what the Qlent Schema may look like. 




Usted below Is an example of the content of an XML blob. It may conform with the client 
model so that it Is portable with the aient Model components. 




166 




t^ckg r oundcdior " /: 




■1 ^;*v#;l ^t'«^^^ 




167 





' a Type p '? S^r i! ng V. *^' 3 er^e r Pjcope f ,^yMa pp ijn ig g '4>1[ n'ame )^?0t/ >? 
!?!Ro^lsI®3SserVemoles 





^73ferveWQ 3reMap plina°ttgohhecm b 




168 



.^ii ^Tii^t.'iv. "-^-i e>rwBrProper>tyMappxnao"-'(de fault') v"^^ r>. 




£/se Cases 
4.2.1. Drawing a New Display - PUMP 

4.2.1.1. Pre-Conditions 
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a) Process Graphics Package has already been loaded on to the Configuration 
Workspace. 

b) A new display has already been created. 



4.2.1.2. User Action/ System Response 



User Actions 


System Response | 


User selects cirde tool on the PGE display 
toolbar. 


PGE package informs the Generic Diagram 
Control that the cirde tool is active. 


User dicks, drags and releases mouse button 
on the diagram control area to specify cirde 
location and size. 


uiaQram control araws a oroe. 


A grapnic oDjecc is aaoeo to tne aispiay 
model representing the drcle. 


Tree view is refreshed. 


Property view is refreshed. 


uskSi 5cic(^La line or rciAdi lyic 


Sv^pm nror^cs cimjlar to drawina a cirde. 


User selects figures on diagram control. 


Diagram control adds surrounding objects 
into a selected figures list and fires an event. 


User clicks on grouping tool on the PGE 
display toolbar. 


PGE package informs Display Editor view to 
group selected figures. 


Display Editor creates a new composite figure 
from the selected figures and invokes an 
addFigure( ) on Diagram control. 


Diagram control refreshes group display. 


Display Editor sets the current context of PGE 
Package to the newly created group. 


Tree view is refreshed. 


Property view is refreshed. 
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4.2.1.3. Object Collaboration Diagram 
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Figure 6 - Drawing a new display (OCD) 
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4.2.1.4. Post-Condition 

a) A grouped graphic elements representing a pump is now displayed in the display editor. 

J iTreeView ""I 

U@ DcReckdngle3 
I'- @ DcEOipsel 



Tree View 

E]-%l DcComposfteS 

DcRectangJe2 

I I 13 DcRectengle3 
DcEISpsel 



Figure 7 — Draw a pump, grouped output. 



4.2.2. Saving a Display 

4.2.2. 1. Pre-Condltions 

a) Process Graphics Package has already been loaded on to the Configuration 
Workspace. 

b) A previously loaded or created display is active. 

c) The user Is In edit mode. 



4.2.2.2. User Action/System Response 



User Actions 


System Response 


User dicks File | Save from the workspace 
menu. 


Ask for confirmation 


Update the PG object model 


converts and saves the PG display as an 
XML blob 


Update client model 
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4.2.2.3. Object Collaboration Diagram 




Figure 8 - Saving a Display (OCD) 



4.2.2.4. Post-Condition 

a) Display is saved on the database via the client model 

b) Is stored as XML blob. 



4.2.3. Loading a previously saved Display 

4.2.3.1. Pre-Conditions 

a) Process Graphics Padcage has already been loaded on to the Configuration 
Worl<space. 

b) A previously saved display (ex. A group pump) 

c) Note for this scenario, a pump group is consists of other drawing elements : 

A circle and 2 rectangles 




4.2.3.2. User Action/System Response 



User Actions 


System Response 


User selects "Pump" from the File | Open 
Dialog box in the workspace 


Retrieve PG XML blob from the client model 


Map the PG XML blob to PG actual object 
model 


Set-up the proper PGE views 


A pump group is drawn in the diagram view 



4.2.3.3. Object Collaboration Diagram 
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4.2.4. Adding Dynamics to a Display 

4. 2.4. 1 . Pre-Conditi ons 

a) End of Scenario 3 

b) An 10 Binding has 



4.2.4.2. User Action/ System Response 



User Actions 


System Response 


User seiects *'cirde" from tree control. 


Property View gets updated to display 
properties of the circle. 




User selects ^Till Color" and diclcs "Add 
Dynamics" 


A new dynamic element is added to the 
Process Display dynamics collection, 
"PG dynamicl" 


User selects Dynamic Edit Mode (tab) 


The dynamic editor view including the 10 
Bindinq, Dynamic List views are activated. 
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4.2.4.3. Object Collaboration Diagram 




PGE User 



4: 



r Select FIIIColor<) SetConlext( tv^cifdel ) ^ 




6: 

ReLoadO^ 



ton 



onSetected( FillColor) 



Figure 10 - Adding Dynamics - A (OCD) 
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Figure 11 - Adding Dynamics - A (Screen Output) 
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Figure 12 - Adding Dynamics - B (OCD) 
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Figure 13 - Adding Dynamics - B (Screen Output) 




4.2.4.4. Post - Conditions 

A dynamic behavior on Fill-Color has been added to the circle element. 
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• On/Off 

• Changes Color 
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Process Graphics Editor II 
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1 Introduction 



1 . 1 Objectives 

1.2 Objectives 

The objectives for the Smart Process Graphic Display project are: 

1- Integrated - Process Graphic Displays are fully integrated with the configuration and 
runtime subsystems. 

2- Quick Edit/Runtime - Users will be able to quicltly switch to a run-mode to see how 
the display they are working on will look at run-time. Both configuration and runtime 
views can be run simultaneously. 

3- Ease of use - The Process Graphics System will be easy to use. Displays will be 
easy to call up on a wide variety of display devices. No display conversion Is required 
to use displays on different devices. It will t>e easy to design displays for optimum 
usability on specific form factors. 

4- Best engineering practices ~ The system will be designed to facilitate maximum re- 
use of displays and sub-displays through both standard and user-defined libraries, 
display classes, etc, thus minimizing configuration and testing effort. 

5- Separation of the graphics from the scripting engine. [For example, the graphics and 
it dynamics are defined in data (xml) that is interpreted by scripts (C#).] 

6- Flexible data bindings - the Process Graphic Displays are able retrieve data from 
multiple data sources including DeltaV and Ovation, OPC. Web Services, XML Files, 
etc. 

7- Smart Objects - The Process Graphic Displays wilt fully support smart objects. 

8- Longhorn - Designed from the ground up to take advantage of Longhorn 
Technologies and Look/Feel. 

9- Wide range of devices ~ Runs on a wide range of devices - all the way from 
dedicated smart phones up through multi-screen consoles. 



1.3 Overview 

Smart Process Graphic Displays are the center piece of the Starbum release. The display 
fomiat makes use of Microsoft's XMAL format. The XMAL format specifies the properties of 
drawing elements for vector graphics commands. An XMAL script can include static data as 
well as dynamic data. The dynamic elements and attributes can be associated with real-time 
values, historical values, physical properties such as mass-flow and composition, etc. In this 
sense XMAL is data driven. 

XMAL vector images are stored as text-based commands. Since it is vector based, it is 
possible to have the same high quality wherever a display is rendered • whether on smart 
phones, handhelds, or high-end monitors. 

Since XMAL is entirely text based it is convenient for DeltaV to store and emit as a download 
scripts. Using the same techniques used today it is also possible to generate download 
status indicators, pariicipate in version control and upgrades, be managed as part of Class- 
based configurations, etc. Process Graphics are downloaded in much the same way that lO 
and Control. System Setup data. Batch, Advanced Control, and SIS configuration scripts are 
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downloaded today. Since Process Graphics are stored as text, it will also be convenient for 
users to search for text within images. 

At it's core XMAL supports vector graphic shapes consisting of straight lines and curves, 
Images, and text. It supports the basic graphical shapes including rectangles, circles, 
ellipses, and polygons, it also gives developers the ability to control and implement animation 
techniques that can be as complicated as generating three-dimensional morphing effects to 
simple two-dimensional images. All the graphical information is stored in a sequence of 
commands that draw various vector graphic shapes. This information can be converted by 
various methods to display an appltcation>specific graphics image. Scalability is achieved 
without Jagged edges because redrawing instructions are sent to the rendering program, 
rather than sent as pixel values in a bitmap. Rendering engines are defined for each target 
environment. 

Every XMAL element and every attribute of an element in a Process Graphic Display can be 
animated. It supports bitmap-style filter effects for creating high-impact graphics. XMAL's 
filter effects give developers the ability to add effects directly to shapes and text in a manner 
similar to those achieved using professional imaging tools. XMAL has the support for 
blending, tiling, transforming or rotating elements, morphing, offset, merge, and special 
lighting effects. Filter effects can be applied separately or in any combination on a vector 
Image. Special effects such as mouse over features can be assigned to any XMAL graphical 
object. 

XMAL produces small file sizes that allow for fast downloading. Additionally, since DeltaV will 
include both Groups and Composites, it is possible to make a change to a single composite 
and affect many displaysV 

XMAL can be drawn using data at run time that is derived from a number of different sources 
in a distributed computing environment The data can come from DeltaV Runtime, DeltaV 
Historian, ODBC. Web Services, an XML file, or many other sources. To accomplish this an 
abstraction or a logic layer is created to establish the relationship of the data to the XMAL 
graphic. For instance, suppose XMAL describes an Image that represents data in terms of 
pixels (e.g. filling a bar). The real-time data may be stored in units of degrees Fahrenheit. It 
would be necessary to establish some type of logical relationship between the image and the 
data that will be displayed in that image so the end user can view something in a format that 
is easily understood and not subject to misinterpretation. Build-in support from DeltaV will 
provide the scaling before the data value is rendered. 

The overall Process Graphics functionality is realized by two major applications. The 
configuration environment consists of Smart Process Graphics Studio. Smart Process 
Graphics Studio includes several tools that are used for creating graphics and graphic 
components and binding graphics to data sources. The second application is the Smart 
Process Graphics Server. The server provides back-end support for executing Smart 
Process Graphic Displays. 

1.3.1 Smart Process Graphics Studio 

Smart Process Graphics Studio is a visual development workspace designed to create and 
test Process Graphics. Smart Process Graphics Studio lets developers use an integrated set 
of tools to build Process Graphic Displays with a separation between the graphical, functional, 
and data components of displays. This ability to separate the different components results in 
display formats that are more resistant to breaking when changes are made to the data or 
whenever graphic changes are made. Separating out the data bindings also makes it easier 
to bind references to the rest of the system (DeltaV and Ovation), track changes, version 
displays, etc. 

The Smart Process Graphics Editor includes the following: 



^ It is also possible to not effect more than one display by converting the composite from a 
linked to an embedded composite - likely to be the default behavior. 
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• Display Editor 

• Template Builder 

• Data Mapper 

1.3.1.1 Display Editor 

The Display Builder provides the tools and features required to create rich Process Graphic 
composites and displays. The user builds graphic displays and selects elements and 
attributes that are to be given dynamic behavior. 

The Smart Process Graphics Editor also enables developers to create specialized interfaces 
that are sophisticated enough to contain dynamic behaviors and data driven elements that are 
not sourced from traditional DeltaV data sources. For example, the Device, Batch, and 
Advanced Control teams will be able to build application views for each of their applications 
and tie those views to Web Sen/ices provided by each of the respective teams. 

1.3.1.2 Template Builder 

Template Builder lets graphic configuration folks manipulate the complete set of dynamic data 
bindings contained inside a single process graphic display. From this view configuration folks 
can specify the nature of the required data and assign parameters and logic to dynamic 
objects in the graphic displays. 

1.3.1.3 Data Mapper 

Data Mapper enables application developers to define connections between the inputs of an 
XMAL template and data by doing the following tasks: 

• Selecting the XMAL elements to map 

• Specifying the sample XML data file to which the XMAL template will be mapped 

• Connecting the inputs of the XMAL template to the XML data file 

Multiple data sources including DeltaV runtime, DeltaV Historical, XML files, ODBC, Web 
services, etc can be defined. The data from these sources can be linked with process 
graphics. 

1.3.2 Process Graphics Server 

The Process Graphics Server is designed to be a high-performance platform for the 
management and transformation of application data and images. It retrieves information from 
multiple data sources and serves the data to the Process Graphic Displays. 

1.4 In this concept document 

The Smart Process Graphics Architecture includes both Configuration and Runtime 
applications. These applications are identified above as Process Graphics Studio and 
Process Graphics Server. These applications are supported by configuration and runtime 
subsystems and components. This Is illustrated in the drawing below. 
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This document focuses on the configuration aspects of Smart Process Graphics. The runtime 
aspects will be described in a separate document. 

t.5 ThB Process Graphics Editor 
1,5.1 

1.6 The Process Graphics Runtime 
1.6-1 

1.7 References 



1- Process Graphics Editor 

2- IFIX and FIX32 

3- Corel Smart Graphics Studio 

4- Mathematica 5 

5- Longhorn 

6- Customer Feedback 



2 Process Graphics Display Editor Requirements 

2. 1 General Requirements 

2.2 Graphic Primitives 
2.2.1 Ui Controls 

Buttons 
Checkbox 
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2.2.2 Behaviors 

Actions 
Alerts 

2.2.3 Attributes 

Context Menu 
Drag and Drop 

2.2.4 Elements 

Circle 
Rectangle 

2.2.5 Commands 

Cut 

Copy 

Paste 

Move Forward / Backward 



2.3 Parameter References 

Internal 
External 
Aliased 



2.4 Binding to data sources 

2.4.1 Create Input / Output 

2.4.2 Define Functionality of Dynamic Elements 

2.4.3 Binding Input / Outputs to Functions 

2.5 Projects 

2.6 Dispiays 

2.7 Groups 

2.8 Composites 

2.9 Faceplates 

2.10 Dynamos 

2.11 Data Binding Sources 

2.1 1 .1 DeltaV Runtime 

2.1 1 .2 DeltaV Historian 

2.11.3 DeltaV Alarms 

2.11.4 DeltaV Events 

2.11.5 OPC 

2.11.6 XML File 

2.1 1 .7 HTTP Browser Link 

2.1 1 .8 General Web Services 

2.1 1 .9 Yulcon Managed Runtime via ADO 

2.11.10 ODBC 
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2.1 2 Scripting 

2.1 3 Display Format 

2.13.1 XMAL format 

2.13.2 Canvas Size 

2.13.3 References 

2.1 4 Controls 

2.14.1 Real-time Trends 

2.14.2 Historical Plots 

2.14.3 Charts 

2.14.4 Alarm Banner 

2.14.5 Alarm Summary 

2.14.6 Advanced Control 

2.14.7 Batch 

2.15 Tag Group Editor 

2.16 Multimedia 
2.16.1 Sound 
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2.16.2 Video 

2.17 System Preferences 

2.17.1 Color 

2.17.2 Fonts 

2.17.3 Locale 

2.18 Reports 

2.19 Diagnostics 

2.20 Performance Checking Displays 

2.21 Experts 

3 Process Graphics Display Requirements 
3.1 General Requirements 

4 Platform Requirements 

4.1 Tablet 

4.2 Multi-screen Configurations 

4.3 Handhelds 

5 Process Graphics Runtime Requirements 

Requirements that affect the PGE. 

5. 1 Loading a Display / Project at Runtime 

5.2 Preloading Displays 

5.3 Display Navigation 

5.4 Custom Keyboard 

5.5 Multi-screen Monitor 
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6 Scenarios 

6. 1 User Creates Display 

6.2 Building a Display 

6.3 Building a Composite 

6.4 Working with Controls 

7 Process Graphic Design 

7.1 Configuration Workspace 

7.1.1 Multi-document Interface 

7.1.2 Projects 

7.2 Displays 

7.2.1 Format 

7.2.2 Linking 

7.3 Menus and Toolbars 

7.3.1 Menus 

Open 
Save 
Close 
Copy 

7.3.2 Toolbars 

7.4 Views 

7.5 Controls 

7.6 Interface with Configuration 

7.7 Interface with Runtime 

7.8 Display Quickview 

7.9 Project Files 

XMAL File Format 

References 

Bitmaps 

Other project files 



189 



7.10 
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Process Graphics 
Edit, Save, Download, Run 
General Scenario 
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1 Introduction 

This document describes a few general 'Edit-Save-Oownioad-Run' Process Graphics Session. 



1 .1 Use Cases 

The Use Cases that are described in this document include: 



1. Using Static and Dynamic Text 

2. Using Data Entry Fields, in this case a simple Text Entry Box 

3. Using Graphic Elements, in this case a Pump 



1 .2 Overview of the Process Graphics System 

1 .2. 1 General Overview 

The overall Process Graphics Architecture Is made up of a combination of Configuration and Runtime 
Components. These components are supported by other subsystems such Control, Communications, 
etc. The Configuration System is linked to the runtime through a supporting Runtime workspace and 
a set of pre-built files providing a set of known behaviors. This set of relationships is illustrated below. 



Procass Graphic 
Editor 



Intar-SubsystBin 



Process Graphic 



Process Graphics Subsystems 



Subsytem interface 



Disptoy 
Definition 



Display IModulss 



Inter-Subsystem 

Interface ^ 



Run-time 
Control 



Display Execution Subsystem 



Subsytemimeilaoa 



Control 
Definition 



Control Modules 



Inter-Subsystem 

" interface 



RurwUme 
Control 



Control and Process Module Execution Subsystem 



Figure 1. Process Module Class "Sub-system Relationships" 



1 .2.2 Configuration and Runtime Constructs 

Similar to Control Strategy configuration there are Primitives. Composites. Classes, and Templates. 
These are described here. 

Primitives - pre-built components that are built and distributed as components. Primitives have built- 
in behavior. In some cases the behavior is very simple, add two things together, while In other cases 
the behavior Is quite complex as In a BOI control. Each primitive In the editor has an SVG equivalent 
(although one editor primitive may be translated into multiple SVG objects, e.g. multi-line text, gradient 
filled objects etc.). 



Library Composites - pre-built collections of primitives and scripting. We will provide libraries of 
composites. Users can also create their own library of composites. These library composites can be 
composed of any arbitrary collection of display fragments, including static and dynamic components. 



194 



Classes - Component classes correspond to reusable display composites. When an instance of a 
class is created on another display the user can override the public parameters defined in the class, 
together with its viewport characteristics (position on screen, size). 



Templates - pre-built collections of primitives and scripting. Templates are libraries of pre- 
built displays in the library which can be used as the starting point for creating new displays. 



The arrangement of constructs is illustrated in the illustration below: 



Site 

Function Blocks 
Modules 
Plant Areas 
User Accounts 
Events 

Other Defintions 



Organizational 



Functions 



Parameters 



Primitive 



Definitions 



Function BlocK Defn 
Modules Class 
Links 
Attributes 
Display Class 



Definition & 
Usage 



Plant Area 



Display 



Parameters 



Instance 



Control 
Modules 



Workstation 
Nodes 



Nodes 



Figure 2. Display IVIodel 
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1.2.3 Models 

1 .2.4 Configuration Model 

The scenarios in this docunnent make reference to the following model: 

Figure 3. Configuration Model 
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1.2.5 Runtime Model 

The scenarios in this document mal^e reference to the following model: 
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1 .2.6 Configuration Workspace / Tools 



The configuration workspace used in these scenarios makes use of a number of features. A snapshot of 
the editor is included below. 




Figure 5. Process Graphics Configuration Tools 
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1 .2.7 Summary of Files 

There are a number of files used in the Process Graphics scenarios discussed in this document. These 
files support both Rich (Win Fomns) and Thin Clients (IE, Handhelds). Rich Clients can directly load the 
native XML format. Thin Clients make use of a combination of SGV and Java scripting. Using display 
'dynamic' the following files are used: 



dynamic.SVG/XMAL 


The Rich Client files will be in XML format. 


OpenDisplay.aspx 


Ininal HTML file - used to select display to be displayed. 


OpenDisplayjs 


Works with OpenDisplay.aspx to open initial display. 


FunctionB locks js 


Provides display element dynamic behavior. 


dynamic.dvg.SVG/XMAL 


SVG/XMAL format of dynamic.SVG/XMAL file. 


dynamic.dvg.js 


Provides dynamic [i.e. scripting] behavior for display •dynamic.SVG/XMAL' 



The relationship of the files is illustrated and discussed below. 



Configuration 
Tools 

(E.g. user editing display 'dynamic*) 




Figure 6. Display Storage 
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1 .3 Background for Scenarios 

1 .3.1 Sample Configuration Used in the Scenarios 
Site 

+ Library 

+ System Configuration 
+ Recipes 
+ Setup 

+ Control Strategies 
+AREA_A 

+ Display Directory 

+ DISP_1 
+ MLMOD 
+ Physical Network 

+ Control Network 

+ USAUST-DELLBERT 

+ Assigned Modules 

+ MLMOD 
+ Operator 

+ OVERVIEW 

The Control Module 'MLMOD' contains the following algorithm: 



SUB 



suei 


B 




an r 






f3 



PERIOD r I 



SOON 
SOONt 



re 



cut r 



fl 



AOO 



12 



OV 



OM 
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2 Scenario - Static and Dynamic Text 

2.1 Create Display •DISP.I ' 

2.1.1 Preconditions 

1- Explorer View is Started 

2- Area 'AREATA* exists 

3- Module 'MLMOD' exists 

2. 1 .2 Postconditions 

1- Display *DISP_1 * created with Static and Dynamic Text Fields added to display 

2- Display *DISP_r is executing in the runtime 

3- Display 'DISP_V is receiving and processing updates 

2.1.3 Scenario 

1- User creates Display *DISP_1 ' under Display Directory of Area 'AREATA* 

2- User creates static text item on Process Graphic *DISP_V. 

a. User selects Text Item' on pallet and draws a Text Box. A text object Is created at the 
cursor and stretched until the user releases mouse. 

NOTEiThe text object is added to the display model at ttie active display root This 
display root is the root for the current drill down level. If not drilled down this is the root of 
the display. 

b- User fills the static text box with the text 'LOOP-101 

3- User creates dynamic text item on Process Graphic 'DISP_1'. The value is to be directly bound 
to process value V/MLMOD/OUT.CV 

a. User selects Text Item' on pallet and draws a Text Box. A text object is created at the 
cursor and stretched until the user releases mouse. 

b. The user selects the dynamics menu context menu option of an existing text object. 

c. The user selects "Add" 

d. The user picks the "textFloat" property, and sets the data source to 
7/MODULE/ATTR.FIELD", in this case "//MLMOD/OUT.CNT. 

e. The user optionally sets offset and scaling. 

f. The user OKs the dialogs 

4- User Saves Display 'DISP^V In Area 'AREA_A' (note, displays can be saved into a particular 
context, e.g. Area. Unit, Library). The display is stored into the database as an XML document 
The top level public parameters of the display are extracted and represented as DB objects which 
can be manipulated through the explorer. The status of the display is initially set to "Not 
published**. 



201 



2. 1 .4 Component Sequence Diagram 



2.2 Download Display 'DISP.I' 



2.2.1 Preconditions 

1 - Display 'DISP_1 ' has been created 

2- Display 'DISP_1' has not been assigned or downloaded 



2.2.2 Postconditions 

1 . Display 'DISP^I ' is assigned to node 'USAUST-DELLBERT 
2- Display 'DISP_1' has been downloaded 



2.2.3 Scenario 

1- User Assigns Display •DISP_1 ' to Workstation 'USAUST-DELLBERT. 

2- The user changes the status of the display to published. This causes the SVG and JS script to 
be generated. Since these scripts have never been downloaded (in fact if these scripts differed 
from the previous scripts), the display is marked as requiring download. 

a. SVG script 'DISP^I .dvg.svg' is created 
<?xml version=**1.0**encoding='*utf-8" stancfalone=*'yes*'7> 

<svg xmlns:dv="abodefg" id="id_SVG" width="1024" height="768" onload="loadSvg(evt);"> 
<defs/> 

<g dv:type='*canvas" dv:update-period=*'500'*> 
<rect width="1024" height="768" fill="#ebebeb" /> 
<g dv:type- 'none"> 

<rect x="2" y="2" wldth="1020" height="764" flll="none" stroke="#000000" stroke-wfdth="1" /> 

</g> 
</g> 
<g> 

<g> 

<rect x="50" y=:"50" width="70" hei9ht="2S" fill="#d3d3d3" /> 

<text x="50" y="66" fill="#O000OO" text-anchor="starf'>LOOP-101<rtext> 

<g> 

<rect x="130" y="50'* width='TO" herght="25" fill='*#d3d3d3" /> 
<text x="130" y="74" fill="#000000" text-anchor="start">0.00 

<dv:dynamics id="id_DYNAMICO" tags'-MLMOD/OUT.CV* attribute="text" 
valueConditioning="vat=fmt(val,2)"/> 
</text> 
</g> 
</g> 
</g> 
</svg> 



b. Java script 'DISP^I .dvg.js' Is created 
upd atePeriod Ms=500 ; 



3- User selects downloads display 

a. The download process transfers the SVG and JS scripts to the display web server. 

i. SVG script 'DISP_1 .dvg.svg' is transferred to the display server (i.e. Starburn 
Server & PRO+ nodes). 
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li. Java script 'DISP^I dvg.js' is transferred to the display server (i.e. Starburn 
Server & PRO+ nodes). 

b. A download process transfers list holding set of displays and over-rides to their 
parameters is generated 

i. A download script giving a list of displays for workstation 'USAUST-DELLBERT 
is downloaded to 'USAUST'OELLBERT 

il. A download script providing list of over-rides for display *DISP_r is downloaded 
to node 'USAUST-DELLBERT 

2.2.4 Component Sequence Diagram 

2.3 Load Display 'DISP_1' into Runtime 

2.3.1 Preconditions 

1- Display 'DISP_1 ' has been downloaded to workstation 'USAUST-DELLBERF 

2- Module 'MLMOD' has been downloaded 

2.3.2 Postconditions 

1 - Display 'DISP_1 * loaded 

2- Dynamic Text fields are updating 

2.3.3 Scenario 

1 - User loads the display into the runtime 

a. The display web server receives a URL to openDispIay.aspx specifying the display to 
open and any parameter overrides. 

b. openDispIay.aspx constructs a web page built up of 

i. Javascript to provide dynamic behavior 

1 . OpenDisplay.js - the JavaScript library of methods to parse and control a 
display and Its communications 

2. FunctionBlocks.js - the library of function blocks available for scripting 
behavior Parameter overrides for the display 

3. DISP_1 .dvg.js - the display specific JavaScript 
ii. Embedded SVG viewer 

1 . The display specific SVG file 'DISP^I .dvg.svg\ The SVG file contains all 
the SVG content required to statically render the display 

2. a definition of all the dynamic behaviour using DeltaV specific tags 

2- Static parts are loaded - the Embedded SVG viewer will render the initial view from the SVG 
definition. 

3- Dynamic links are identified and bound - 
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a. The onload processing will then fire off the javascript which searches the SVG for deltaV 
tags which identify dynamic behavior. Depending upon the type of dynamic ( directly 
bound, user updatable. fb algorithm etc ) structures are built up to allow to allow rapid 
traversal of the dynamic components. 

4- There are components for registering for updates from the runtime 

a. All aliases are resolved, the process value paths are extracted , and the list is sent to the 
data server to register for updates. 

b. A session ID Is returned to the JS code in the web page. If at any time the value of any of 
the aliases in a display is changed ( by the user or by an algorithm ) then the current 
update registration is cancelled and a new list of process value paths is extracted and 
registered for updates. 

2.3.4 Component Sequence Diagram 

2.4 Process Updates Display 'DISP_1' 

2.4.1 Preconditions 

1 - Display 'DISP_1 ' has been loaded 

2- Display *DISP_1' has registered for updates 

2.4.2 Postconditions 

1- Display •DISP_V processed update from the field 

2- Dynamic Text Field updated 

2.4.3 Scenario 

1- An update to 7/MLMOD/OUT.CV is received from the runtime. 

2- The update is received and stored as a new value for the parameter. 

3- At the display refresh period, all defined dynamic behaviors within the display are executed, 

4- Dynamic behaviors update variables which in turn result in SVG properties being updated. 

5- User sees updates to the display. 

6- If any of the processing results in changes to process values, then the process values are sent to 
the data server which then pushes them through the OPC interface into the runtime. The new 
value is reflected back to the web page through the usual periodic update mechanism. If any of 
the aliases are changed then update registrations are updated as described above. 



2.4.4 Component Sequence Diagram 
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3 Scenario - Data Entry Field 

3.1 Create Data Entry Field 

3. 1 . 1 Preconditions 

1 - Explorer View Is Started 

2- Area 'AREATA' exists 

3- Module 'MLMOD' exists 

3. 1 .2 Postconditions 

1 - Display 'DISP^I ' created 

2- Static and Dynamic Text Fields added to display 

3.1.3 Scenario 

1- User... 

2- The following is created . . . 

<?xml version="1 .0" encodjng="UTF-8"?> 
< Results schema="1 .0"> 
<Site name=*The Site"> 
<PlantAreas> 
'^PIantAreas> 
</Site> 
</Results> 

3- Explorer View Shows Process Cell •LINE_1 * 

3. 1 .4 Component Sequence Diagram 

3.2 Download Data Entry Field 

3.2. 1 Preconditions 

1- Explorer View is Started 

2- Area "AREA.A* exists 

3- Module 'MLMOD' exists 

3.2.2 Postconditions 

1 . Display •DISP_1 * created 

2- Static and Dynamic Text Fields added to display 

3.2.3 Scenario 
1- User... 
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2- The following is created . . . 

<?xml version="1.0" encoding="UTF-8"?> 
< Results schema="1.0"> 
<Site name- The Slte"> 
<PlantAreas> 
</PlantAreas> 
</Site> 

</Results> 



3- Explorer View Shows Process Cell 'LINE_1' 



3.2.4 Component Sequence Diagram 



3.3 Load Data Entry Fields into Runtime 



3.3.1 Preconditions 

1- Explorer View is Started 

2- Area •AREA_A' exists 

3- Module 'MLMOD' exists 



3.3.2 Postconditions 

1- Display 'DISP^V created 

2- Static and Dynamic Text Fields added to display 



3.3.3 Scenario 

1- User ... 

2- The following is created . . . 

<?xml verslon="1.0" encoding="UTF-8"?> 
< Results schema-* 1.0"> 
<Site name- The Site"> 
<PlantAreas> 
</PlantAreas> 
</Site> 
</Results> 



3- Explorer View Shows Process Cell 'LINE_1 * 



3.3.4 Component Sequence Diagram 
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3.4 User Changes Value Through Data Entry Form 

3.4. 1 Preconditions 

4- Explorer View is Started 

5- Area 'AREATA* exists 

6- Module 'MLMOD' exists 

3.4.2 Postconditions 

3- Display *DISP_1 * created 

4- Static and Dynamic Text Fields added to display 

3.4.3 Scenario 

4- User... 

5- The following Is created . . . 

<?xml version="1.0" encoding="UTF-8"?> 
< Results schema=**1.0**> 
<Site name='The Site"> 
<PlantAreas> 
</PtantAreas> 
</Site> 
</Results> 

6- Explorer View Shows Process Cell *LINE_1 " 

3.4.4 Component Sequence Diagram 

4 Scenario - Graphic Item Pump 
4.1 Create Graphic item 'PUMP_1' 

4.1.1 Preconditions 

1 ' Explorer View Is Started 

2- Area 'AREATA' exists 

3- Module *MLMOD' exists 

4.1 .2 Postconditions 

1 - Display 'DISP^I * created 

2- Static and Dynanrtic Text Fields added to display 

4.1.3 Scenario 
1- User... 
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2- The following is created. 



<?xml versions" I.Q- encoding ="UTF-8"?> 
< Results schema="1.0"> 
<Site name=The Site"> 
<PlantAreas> 
</PlantAreas> 
</Site> 
</Results> 



3- Explorer View Shows Process Cell *LINE_1 ' 



4, 1 A Component Sequence Diagram 



4.2 Download Display With Graphic itenn 'PUMP1 ' 



4.2.1 


Preconditions 


1- 


Explorer View is Started 


2- 


Area 'AREATA' exists 


3- 


Module 'MLMOD' exists 


4.2.2 


Postconditions 


1- 


Display 'DISP_1' created 


2- 


Static and Dynamic Text Fields added to display 


4.2.3 


Scenario 


1- 


User ... 


2- 


The following is created ... 




<?xml version="l .0" encoding="UTF-8"?> 




< Results schema="1 .0"> 




<Site name='The Sjte"> 




<PlantAreas> 




</PlantAfeas> 




</Site> 




</Results> 


3- 


Explorer View Shows Process Cell 'LINE^I" 



4.2.4 Component Sequence Diagram 

Load Display With Graphic Item 'PUMP1' 

Preconditions 

Explorer View is Started 
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Area 'AREATA* exists 
Module 'MLMOD' exists 
Postconditions 
Display 'DlSP^r created 

Static and Dynamic Text Fields added to display 

Scenario 

User ... 

The following is created... 

<?xml verslon="1.0" encoding="UTF-8"?> 

< Results schema="1.0"> 

<Site name='The Stte"> 
<PlantAreas> 
</PlantAreas> 

</Slte> 
</Results> 

Explorer View Shows Process Cell 'LINE^r 

Component Sequence Diagram 

Process Updates for Graphic Item PUMP_1' 

Preconditions 

Explorer View is Started 

Area 'AREATA' exists 

Module *MLMOD' exists 

Postconditions 

Display 'DISP_r created 

Static and Dynamic Text Fields added to display 

Scenario 

User ... 

The following is created... 

<?xml ver3ion="1.0" encoding="UTF-e'*?> 

< Results schema="1.0"> 

<Site name='Tho Site"> 
<PlantAreas> 
</PlantAreas> 
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</Site> 
</Re8ults> 

Explorer View Shows Process Cell 'LINE_1* 

Component Sequence Diagram 

User Sends Command 'Start' to Graphic Item PUMP1' 

Preconditions 

Explorer View is Started 

Area 'AREATA' exists 

Module 'MLMOD' exists 

Postconditions 

Display 'DlSP^I * created 

Static and Dynamic Text Fields added to display 

Scenario 

User ... 

The following is created... 

<7xml verslon="1 .(y* encoding=-UTF-8"?> 
< Results schema=-1.0"> 

<Site name=The Site''> 

<PlantAreas> 

^lantAreas> 

</Site> 
</Results> 

Explorer View Shows Process Cell 'LINE^V 
Component Sequence Diagram 
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1 Introduction 



1 .1 Query and Command Objectives 

1. Improve Overall Configuration Integration 

• One framework for all tools 

• Common controls across all tools 

• Large System configuration performance improvements 

2. Support Multiple Development Centers 

1.2 Use Cases 

1. Read 

• Find 

• Verify Module 

• Bulk Read 

• Load Graphic 

2. Command 

• Create Card 

• Rename Module 

• Delete - Block Usage, Process Cell. Parameter 

• Set Properties 

• Enable Device Alerts 

• Connect Block to Fieldbus 

• Instantiate a Block 
« New Card 

• Save Module 

• Save Graphic 

3. Services 

• Import/Export 

• Download 

• Find 

• Verify 

• Bulk Write/Update 
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2 General Configuration Scenarios 
2.1 Background for Scenarios 

2.1.1 Sample Hierarchy 

Several of the scenarios make use of the following hierarchy: 



Site 

+ Library 

+ System Configuration 
+ Recipes 
+ Setup 

+ Control Strategies 

+AREA_A 

+ LINE_1 

+ BOILER_A 

+ WATERJNLET_FLOW 

+ VALVE_1 

+ FLOW_METER_1 

AM -> FFAI1 
+ PLM_1 

+ Physical Network 

+ Control Network 
+ CTRL1 



I/O 



+ C01 



CH01 
CH02 



+ C01 



+ P01 



PDT1 



FFAI1 
FFAI2 
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2.1 .2 Component Hierarchy 



The scenarios in the following sections make use of several new components and interfaces. These 
components provide Query Services for clients. The Query and Command Components are the topic 
of the following scenarios. The specialized services are not covered in this document. 




Figure 1. Component Layers 
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2.2 Expand Area 'AREATA' 



2.2.1 Preconditions 

1- Explorer View is Started 

2- Area 'AREATA* not expanded. 



2.2.2 Postconditions 

1- Area •AREA_A' expanded 

2- Explorer shows Process Cell 'LINE_1' 



2.2.3 Scenario 

1- User selects Area 'AREATA' 

2- App generates query 

Site.PlantAreas[name=*AREA_A*]().SubEqulpmentltems(name.type.desc) 

3- Query results returned 

<?xml version="1 .0" encodlng="UTF-8"?> 
< Results schema=''1.0"> 
<Site name='The Site*'> 
<PlantAreas> 

<PlantArea name='*AREA_jA**> 
<SubEquipmentltems> 

<Equtpmentltem name='T.INE_1'*> 
<Propertles> 

<type>PROCESS_CELL</type> 
<description> A Process Cell for LiNE_1</descriptton> 
</Properties> 
</Equipnientltem> 
</SubEquipnnentltems> 
</PlantArea> 
</PtantAreas> 
</Site> 
</Results> 



4- Explorer View Shows Process Cell 'LINE_1 • 
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2.3 Expand Process Cell 'LINE.1 ' 



2.3. 1 Preconditions 

1 - Area 'AREATA* expanded . 



2.3.2 Postconditions 

1- Process Cell *LINE_1 ' expanded 

2- Explorer shows Unit Module 'BOILER^A' 



2.3.3 Scenario 

1- User selects Process Cell *LINE_1 * 

2- App generates query 

Site.PlantAreastname='AREA_Al().SubEquipmentltemsIname=*LINE_11(). 
Equlpmentltems(nanne.type,description).UnltModuIe.AssignedTo(name) 

3- Query results returned 

<?xml verslon="1.0'* encoding="UTF-8"7> 
<Results schema="1.0"> 
<Site name=*The Site'*> 
<PlantAreas> 

<PlantArea name="AREA_A"> 
<SubEquipment1tems> 

<Equipnnentltem name-'LINE_1"> 
<Properties> 

<type>PROCESS_CELL</typ8> 
<descriptlon> A Process Cell for LINE.1 </descriptton> 
</Properties> 
<SubEquipmentltems> 

<Equipmentltem name="BOILER_A"> 
<Properties> 

<type>UNIT</type> 
<description> A Unit </description> 
<assignedTo name="CTLRr7> 
</Properties> 
</Equipmentltem> 
</SubEquipmentltems> 
</Equipmentltem> 
</SubEquipmentltems> 
</PlantArea> 
</PlantAreas> 
</Site> 
</Results> 

4- Explorer View shows Unit 'BOILER_A' 



2.3.4 Component Sequence Diagram 
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2.4 Create Process Cell 'LINE 2' under Area 'AREA A' 



2.4.1 Preconditions 

1- Area 'AREATA* expanded. 

2- Explorer positioned on Area 'AREATA* 



2.4.2 Postconditions 

1- Process Cell •LINE_2* created under Area •AREA_A* 

2- Explorer shows Process Cell •LINE_2' with desc 'Cooling Water System* 

2.4.3 Scenario 

1- User right clicks Area 'AREATA' and selects Create Process Cell 

2- User enters name •LINE_2' and sets description to 'Cooling Water System' 

3- App creates command script^ 

Import System 

Import DeltaV.Config.Command 
Function Command() 

Var areaContext=ltem^.Open("Site.PlantAreas(name='AREA_AT); 

Var pceIIContext=areaContext.execute(''createProcessCell(name='LINE_2')"); 

poellContext.executeCsetPropertiesCdescriptions'Cooling Water System')"); 



4- Command engine executes script (details shown in sequence diagram) 

5- Command engine returns success 

6- App generates query to load equipment items 

Site.PlantAreas[name='AREA_A'](name).SubEquipmentltems(name,type.descripti( 

7- Query results returned 

<?xml version="1.0" encoding="UTF-8"?> 
< Results schema- '1 .0"> 
<Site name='The Site"> 
<PlantArea5> 

<PlantArea name="AREA_A"> 
<SubEquipmentltems>' 

<Equipmentltem name- "LIN E_r'> 
<Properties> 

<type>PROCESS_CELL</type> 
<description> A Process Cell for LINE_1</description> 
</Properlies> 
</EquipmentItem> 
<Equipmentltem name- *LINE_2"> 
<Properties> 

<type>PROCESS_CELL</type> 
<description>Cooling Water System</description> 
</Properties> 
</Equipmentltem> 
</SubEquipmentltems> 



' The command script is JScript 
^ Item is written in C# 
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</PlantArea> 
</PlantAreas> 
</Site> 
</Results> 



8- Explorer View shows Process Cell 'LINE_2* 



2.4.4 Component Sequence Diagram 



2,5 Create Dl Card under Controller 'CTLR1' 

2.5. 1 Preconditions 

1 • Controller 'CTLRI ' expanded. 
2- No card exists in Slot 3 

2.5.2 Postconditions 

1 - Dl Card created under Controller 'CTLRI ' 

2- Explorer View shows card 'COa' of type 'Dl Card, 8 Ch., 120VAC. Dry Contact' 

2.5.3 Scenario 

1 - User right clicks on Controller 'CTLRI ' and selects 'Create Card' 

2- App Generates Query 

Site.PCN.ACN.Nodetname='CTLR1].IO[index=1].validCardTypes(defname,Ulname,revlsion) 

Site.CardDefns[nanrie=defname].channel(posltlon).valldChannelTypes(defnanrie,Ulname,revlsion) 

« NOTE - need to issue the first Query and then use the results to generate the TP"^ query.,, not 
shown here » 

3- Query Results Returned 

4- Selection Dialog Populated 

5- User Selects Dl Card. 8 Ch., 120VAC, Dry Contact, Slot=3 

6- App creates command script^ 

Import System 

Import OeltaV.Config.Command 

Function CommandO 

{ 

Var controllerContext = ltem.Open("Site.pcn.acn.node(name='CTLR1'].IO[index=1)"); 

Var cardContext = controllerConext.execute("cneateCard(sIot=3,defname="DL8CH_1 15VAC_DCT"); 

// repeat for all eight channels 

For (ch=1;ch <= number_of_channels: ch++) 

^ The conunand script is JScript 
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Var channelConext = Card.executeCcreateChanneKchannel- Vtype- DLCHAN*); 
channelContext.execute(*createDST(dstName=''*"); 

) 

) 



"OR", the preferred mechanism, have the server side create the channels. In this case the script would simply be: 
Import System 

Import DeltaV.Config.Command 

Function Command() 

{ 

Var controllerConlext = Item.Openf Site.pcn.acn.node(name='CTLR1*J.IO(index=ir); 

Var cardContext = controllerConext.execute{"createCard(slot=3.defhame="DL8CH_1 1 SVAC.DCT"); 

> 

7* Command engine executes script (details shown in sequence diagram) 

8- Command engine returns success 

9- App generates query to load node items 

Site.pcn.acn.node[name='CTLR1'].IO[index=1].card(name).channel(name.description,dst); 

10- Query results returned 

<?xml versions" 1 .0" encoding- *UTF-8"?> 
< Results schema="1.0"> 

...need an example... 

</Results> 

11- Explorer View shows Card 'C03' under Controller 'CTLR1 * 
2.5.4 Component Sequence Diagram 



2.6 Convert FB 'AM' from defn 'Al' to TFAI' (w/o updates) 

2.6.1 Preconditions 

1- Module TLOW_METER_r contains FBU 'AM' from definition 'Al' 

2- User has explorer view open on module 'FLOW_METER_1* 

2.6.2 Postconditions 

t- Module TLOW^METER.r contains FBU 'AIV from definition TFAI* 

next items come into piay if there is view up that contains these items, i.e., something has to 
have registered for updates 

2- Parameters disappear (some) 
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3- Lines disappear (some) 

4- Bindings disappear (Ail initiaiiy bound to 'CTLR1/iO1/C01/CH1 ') 

5- Over-rides are maintained witere appiicabie 

2.6.3 Scenario 

1- User selects FBU 'All ' and selects choice •Convert to Fleldbus' 

2- App creates commands 

Import System 

Import DeltaV.Config.Command 
Function Commando 

* Varfbu=ltem.Open(-Site.moduleslname='FLOW_METER_Vl.blocks[name='AI1]"); 
fbu.executeCsetblockdefinitionCFFAi')"); 

} 

3- Command engine executes script (details sfiown in sequence diagram) 

4- Command engine returns success 

5- App generates query to load items 

Site.modules[name='FLOW_METER_1l.blocks(..); 

» loading all of the details in the blocks since there could be many changes (including parameter 
deletions, renames, and defn changes). 

» also, need to re-run this scenario with a Control Studio type view to show the lines, parameter 
changes (disappearing/adding), and parameter over-rides 

6- Query results returned 

<?xml version="1.0" encoding ="UTF-8"?> 
< Results schema="1.0"> 

...need to oomplere example... 

</Results> 

7- Explorer View shows updated definition 



2.6.4 Component Sequence Diagram 



2.7 Convert FB *AI1' from defn 'Al' to TFAI' (w/ updates) 

For tiiis scenario we simplified tiie hierarciiy - the modules VALVE_1'and 'FLOW_METBR_r t^ave been 
moved up directly under Area 'AREA_A\ 
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There were side coriversations here on how to approach this whole area of updates, it was agreed that 
providing the users with preferences would be ideal: 

1- Refresh Immediately 

2- Refresh periodically (time specified by user) 

3- Flag changes but dont refresh, manually refresh 
4' Do not flag changes, manually refresh 

2,7 A Preconditions 

1- Module TLOW_METER_1 * contains FBU *AI V from definition 'Al* 

2- Module •FLOW_METER_1 ' contains FBU 'CALC1 ' with an internal reference ''^/AM/OUT.CV. 

3- Module VALVE_1 * contains external reference parameter 'P1 ' referencing 
•FLOW_METER_1/AI1/OUT.CV\ 

4- User has explorer view open on module 'FLOW_METER_1 ' 

2.7.2 Postconditions 

1 - Module 'FLOW^METER^I ' contains FBU 'Air derived from definition 'FFAI'. 

2- Internal and external references described in Preconditions are maintained. 

3- Binding to •CTLR1/IO1/C01/CH1/FIELD_VAL_PCr replaced by 'PDTI .FAI1' 

2.7.3 Scenario 

1 - User selects Area 'AREATA' 

2- App generates query 

updateContext=(Site.PlantArea[name='AREA_A'].(handle)TopLevelModules(handle, name. type, 
desc) 

3- Query results 

<?xml verslon="1.0" encodlng="UTF-8"7> 
< Results schenia="1.0"> 
<Site name='The Slte"> 
<PlantAreas> 

<PlantArea name="AREA_A"> 

<TopLevelModules hanclle="h1"> 

<Moduleltem name="FLOW_METER_1" handle="h2"> 
<Properties> 

<type>MODULE</type> 
<description>A module </description> 
</Properties> 
</Moduleltem> 

<Moduleltem nanne=*VALVE_1" handle="h3''> 
<Properties> 

<typ€>MODULE</type> 
<description>Another module</descriptron> 
</Properties> 
</Moduleltem> 
</TopLevelMod ules> 
</PlantArea> 
</PlantAreas> 
</Site> 
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</Results> 



4- App constructs update list 

collection 'hV 
module 'h2' 
module *h3' 

5- App generates query 

Site.Modules(name='FLOW_METER_r].blocks(handle, name, type, defname, algtype) 

6- Query Results 

<?xml version='*1.0" encoding- •UTF-8"?> 
< Results schema="1.0"> 
<blocks> 

<Blockltem name="Air hand!e="h4"> 

<Properties> 

<type>AI</type> 

</Propertjes> 
</Blockltenn> 

<Blockltem name="CALCr' handle="h5"> 
<Properties> 

<type>CALC</type> 
</Propertles> 
</Blockltenn> 
</blocks> 
</Results> 



7- App builds tree 

8- User selects FBU 'All ' and selects choice 'Convert to Fieldbus' 

9- User browses to 'PDT1/AI1 ' under Node •CTLR1/IO1/C02/P01 ' 

10- App creates commands 

Import System 

Import DeltaV.Config.Command 

Function Command() 

{ 

Var fbu=Item.Open("Site.modules[name=TLOW_METER_1 '].blocks(name='Alin; 
fbu.executeCsetblockdefinitionCFFAr)"); 



11- Command engine executes script (details shown in sequence diagram) 

12- Command engine returns success 

13- Db detects change to FBU 'All' 

14- Db adds all handles it associated with 'Air to the update list 

15- Db sends update list to Config. Updates (part of DvDbServer) 

16- Config. Updates locates client 'MyClienf in update list 

17- Config.Updates sends update notification to Client 'MyClient' 

h4 - associated with FLOW_METER_1/AI1 

h5 - associated with CTLR1/IO1/C01/CH1/FIELD_VAL PCT 

h6 - associated with PDT1/AI1 
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18- Client 'MyClient' receives update and processes updates 

Client 'MyClienf finds AppObject 'FLOW_METER_1/Air using handle •h4' and marks dirty 
Client 'MyCllent' finds AppObject •CTLR1/IO1/C01/CH1/FIELD_VAL_PCT using handle 'hS' and 
marks dirty 

Client 'MyClienr finds AppObject •PDT1/Air using handle 'hS* and marks dirty 

19- Client *MyClient' update thread finds dirty bits 

20- Client 'MyClient* generates query 

Site.Modules[name=TLOW_METER_1]blocks[name='AI1l(handle. name, type, desc) 



21- Query results returned 

<?xml vefsion="1.0" encoding ="UTF-8-?> 
< Results schema="1 .0"> 
<blocks> 

<Blockltem name="AI1" handle="h4"> 

<Propertles> 

<type>FFAI</type> 

</Properties> 
</Blockltem> 

<Blockltem name="CALCV handle="h5"> 
<Properties> 

<type>CALC</type> 
</PrDperties> 
</Blockltem> 
</bIocks> 
</Results> 

22- Client updates appObject 'AM' 

23- Client updates update map (in this case there is nothing to do) 

24- Repeat for •CTLR1/IO1/C01/CH1/FIELO_VAL_PCr. dst1. and 'PDT1/AI1* 



2.7.4 Component Sequence Diagram 



2.8 Change Process Cell Name from 'LINE_1' to 'UTIL' (w/ updates) 

2.8. 1 Preconditions 

1- Area 'AREATA' not expanded. 

2- Process Cell named 'LINE 1' 



2.8.2 Postconditions 

1- Process Cell named 'UTIL' 



2.8.3 Scenario 

1* User selects Area 'AREA A' 
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2- App generates Query 

Site.PlantArea[name='AREA_Al,(handle)EquipmentJtems(handle,narne,type) 

3- Query Results 

<?xml versfon="1.0" encodlng="UTF-8"?> 
< Results schema="1.0"> 

<Equipmentltems handle- *h1'*> 

<EquipnrientltGm name- 'LINE^V handle="h2"> 
<Properties> 

<type>PROCESS CELL</type> 
</Properties> 
</Equlpmentltem> 
</Equipmentltems> 
</Results> 

4- User selects Process Cell 'LINE_1' and renames to 'UTIL' 

5- App generates command 

Import System 

Import DeltaV.Config.Command 

Function Commando 

{ 

Var context=ltem.OpenrSite.Equipmentltems(name='LINE_lT); 
context.executeCrenameToCUTIL')"); 



6- Command engine executes script and returns DB_SUCCESS 

7- Db detects changes to Process Cell 'UTIL' 

8- Db adds handle 'h2* to change list, contains hintCrename', •LINE_1\ 'UTIL') 

9- Db sends update list for client 'MyCllenf 

10- DvDbServer locates 'MyClienf in update map 

11- DvDbServer sends update notification with 'h2' to Client 'MyClienf 

12- Client 'MyClienr receives update list, marks items dirty 

13- Client 'MyClienf update thread finds dirty bits 

14- Client 'MyClient* generates query 

Site.PlantArea[name=*AREA_Al.(handle)Equipmentltems(handle,name.type) 



...alternative... 



16- Client 'MyClienf compares existing to new name. Since the client already processed the update, 
i.e. when it did the rename, it does not execute a new query sequence. 



8.4 Component Sequence Oiagrann 
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2.9 Change name of FBU 'Ai1' to TLOW1' (w/updates) 

In this scenario we expand out the hierarchy to illustrate how the update handles are allocated and later 
incorporated into the updates. Only the Control Strategy updates are considered in the discussion. 

2.9.1 Preconditions 

V 

1- Area *AREA_A' not expanded. 

2- FBU 'Air exists in Module TLOW_METER_1 ' 

2.9.2 Postconditions 

1 - Area *AREA_A* fully expanded 
2- FBU 'AW renamed to TLOW1 * 

2.9.3 Scenario 

The drawing below provides background information on the scenario: 
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1- User selects Area 'AREA.A' and expands it 

2- App generates series of sequence as user expands hierarchy 

Site.PlantAreas[name='AREA_A*l.(hand»e).Equipmentltems(handle.name.type) 

Site.Equipmentltems[name='LINE_1Khandle).Equipmentltems(handle.name.type) 

Site.Equipmentltems[name=*BOILER_Al.(handle).TopLevelModules(handle,name,type) 

Site.TopLevelModulesIname='WATERJNLET_FLOWl.(handle).TopLevellVlodules(handle,name. 
type) 

SiteTopLevelModules[name=TLOW_METER_1l.(handle).BIocks(handle.name,type) 
Site.TopLevelModules[name=VALVE_r].(handle).Attributes(name,type.ref) 

SiteTopLevelModules[name='FLOW_METER_1l.(handle).BIocl^s[name='CALC1l.Attributes(na 
me.type.expresslon) 



3- User selects FBU 'AM ' and renames it to 'FLOW1 ' 

4- App generates command sequence 

Import System 

Import DeltaV.Config.Command 

Function Command() 

{ 

Var context=ltem.Open(-Site.TopLevelModule[name=TLOW_METER_ri.BlocksIname='AMT): 
context.execute("renameTo('FLOWV)'); 



NOTE - alternatively, we also discussed being able to support this same transaction using handles as show below: 

Function CommandO 
{ 

Var context=ltem.OpenrSite,handles[handle='h11T): 
context. execute("renameTc('FLOW1 *)"); 



5- Command Processor executes script 

6- Db detects changes to FBU TLOW1 * 

7- Db adds handles 'hi I,h12.h8.h9* to change list, contains hintCrename'. 'LINE_V. *UTIU) 

8- Db sends update list for client 'MyClient' 

9- Client 'MyClient* receives update list, marks Items dirty 

10- Client 'MyClient' update thread finds dirty bits 

11- Process update event *h1 r : Update(handle=*h1 1\ rename.'AM \'FLOWr) 
»rename *Air to 'FLOWI' 

Client renames FBU 'Air to 'FLOWr 

12- Process update event 'hi 2' : Update(handle='h12', assoicatedltem) 
» update on FBU 'CALCr 

Client generates Query 
Site.Handles[handle=*h12'].attributes(...) 
Client updates parameters 
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13- Process update event *h8' : Update(handle=*h8', assoicatedltem) 
» update on module 'FLOW_METER_V 

Client generates Query 

Site.Handles[handle='h8'] 

{ 

(handle) Blocks(handle,name,type); 
attributes(...); 

} 

Client updates 

14- Process update event *h9' : Update{handle='h9', assoicatedltem) 
» update on module VALVE_r 

Client generates Query 

Site.Handles[handle=''h9'] 

{ 

(handle) Blocks(handle,name,type); 
attrlbutes(...): 

} 



2.9.4 Component Sequence Diagram 



2.10 Find all Modules with parameter 'MSTATUS.MASK' with Bit 4 set in Plant 
Area 'AREA A' 



2.10.1 Preconditions 

1- User has launched browser (i.e. Find utility) 

2.10.2 Postconditions 

1- Browser returns list of Modules meeting search/filter criteria 

2.10.3 Scenario 

1- User selects search / filter criteria to find all Modules in Area •AREA_A' with parameter 
*MSTATUS_MASK' with Bit 4 set 

2' App generates command 
Import System 

Import DeltaV.Config.Command 

Function CommandO 

{ 

Var streamHandle = ltem.OpenStream("Site"); 



3- Sender executes command and returns Stream handle 'streamHandle' 

4- App generates command 

import System 

Import DeltaV.Config.Command 
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Function CommandO 
{ 

streamHandle.execute(streamHandle. 

Tind(Site.PlantAreas[name='AREA_A'I..nfiodules.(name.type.path).attributestname="MSTATUS MASK'J.FieldsIna 
me=*CV', value & 0x1000 1= O'f ); ^ 

> 



5- App reads stream 

6- Server returns results 



example... 

<?xml version="1 .0" encoding="UTF-8"?> 
< Results schema="1 .0"> 

<Module name="VALVE_r> 
<Properties> 

<type>MODULE<Aype> 

<path>SltePlantAreas[name«*AREA_A'].Equipmentltems[name=^INE_ri.EquipmentltemsIname='BOIL^ 
Equlpmentltems[name=TLOW_METER_1 •].ModulesIname=VALVE_1 *]</path> 
</Properties> 

</Module> 
</Results> 



7- Repeat 5 & 6 until server is connplete - it then returns search complete status 



2.10.4 Component Sequence Diagram 



2.11 Find all Modules of type 'PLM' in Plant Area *AREA_A' 



2.11.1 Preconditions 

1- User has launched browser (i.e. Find utility) 



2.1 1 .2 Postconditions 

1 - Browser returns list of Modules meeting search/filter criteria 



2.11.3 Scenario 

1- User selects search / filter criteria to find all Modules in Area 'AREATA* of Type 'PLM' 

2- App generates command 

Import System 

Import DeltaV.Config.Command 

Function CommandO 

{ 

Var streamHandle = ltem.OpenStream("Site*): 



3- Server executes command and returns Stream handle 'streamHandle* 
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4- App generates command 
Import System 

Import Delta V.Config .Command 

Function Command() 

{ 

stream Hand le.execute(stream Handle. 
'Find(Site.PtantAreas[name='AREA_A*]..modules.(name,type,path)[type='PLM'r); 



5- App reads stream 

6- Server returns results 

example... 

<?)cml version="1.0" encoding='"UTF-8"?> 
< Results schema="1.0"> 
<Module name="PLM_1"> 
<Properties> 

<type>MODULE</type> 

<path>Slte.PlantAreas[name='AREA_A'].Equipmentltems(name='LINE 1'].Equlpmentltems[name=*BOtLER_A']. 
Equlpmentltems[name='FLOW_METER_1 '].Modules[name='PLM_1 •]</path> 
</Properties> 

</Module> 
</Results> 



7' Repeat 5 & 6 until server is complete - it then returns search complete status 



NOTE - as part of the search the user needs to be able to cancel the search. If the user were to do this 
then the scenario would complete as follows: 

User cancels search 

App sends cancel to Server 

Server aborts search 

Server returns completion status 'Search Cancelled' back to the User 
2.1 1.4 Component Sequence Diagram 
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3 Technical Architecture 



3.1 Overview 

The technical architecture delivers the technical components and frameworks that support what we are 
trying to build. The details of the technical architecture are covered in the Starburn Technical Architecture 
document. 



3.2 Component Architecture 

The drawing below illustrates the initial component map after the exercises executed above. Packages 
have been added to represent the logical components. Most components have an interface added to 
provide services. 



•BinincM Compgncnti 
COantCdmpoMflU 




Figure 2. Component Architecture 
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3.3 Subsystems 



Subsystems provide a high-level view of how the architecture realizes Use Cases without going into the 
low-level details. The concept of subsystems sometimes carries through to implementation In which case 
real components implement the subsystem. 



Subsystem Name 


Subsystem Description 


Operator Worlcspace 


Provides a controlled environment for Process Graphics. Batch Operator 
Interfaces. Advanced Control Applications. Alarm Banner, Alarm Summary, 
Faceplates. Detail displays. History Clients, etc. 


Engineering Workspace 


Provides a controlled environment for Configuring Process Graphics, Batch, 
Advanced Control, Alarms. Displays, Devices, History, etc. 


Process Graphics 


Provide user defined views and operator inter^cing onto the system 
architecture. 


Ul 


Provides Specific Controls, Frameworks for application developers, Ul 
design guidelines, etc 


Configuration 


Provides configuration services for both connected and disconnected clients. 
Connected clients include applications to configure control strategies, 
displays. lO, user accounts, manage configuration, load licenses, etc. 
Disconnected clients are used for bulk editing the system, for interfacing to 
external tools such as INtools, and for addressing customer specific 
requirements with respect to Recipe Management, etc. Also includes 
services for Versioning and Audit Trail. 


Communication 


Provides communication services for control, debugging, configuration, 
alarm & alerts, operator interfaces, etc. 


Data Services 


Provides low level access to the system. This consists of things such as the 
Custom Function Block Interface for interfacing foreign DCS systems (e.g. 
Bailey. Teleperm). 


Session 


Provide support for user logon, session management, secure access to the 
9/91^111, diiu opciri'Oi^coriirc/i. 


Events / Alarm / Alert 
Services 


Allows monitoring and notification of significant system states, 
acixnowieuy^nienis, anu pnoriiy caicuiaiions. 


Licensing 


Provide services to enable functionality on the system using licensing. 


Diagnostics 


Interacts with all of the subsystems to collect diagnostic and alert 
information. 


System Administration 
Services 


Provides services for installing applications and hot fixes. Also provides 
support for remotely monitoring and supporting systems. 


History 


Provides access to continuous, event, and batch data. 


Control 


Provides continuous, sequencing, batch, recipe, process, safe control. 


PIO 


Provides access to all of the lO - including conventional lO, Fieldbus. 
Profibus, DevicNet, Serial, ASI, Remote ID, RS3 lO, Provox lO, Safe lO, etc. 


Report Writer 


Provides reporting services for alarm/alert information, document 
configuration, etc. 
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4 Configuration Applications and Supporting Frameworks 
4.1 Overview 

The configuration applications and their supporting frameworks are illustrated below^. 




Clienl Application Framework 



Client Components 



OettaV 
Components 



Components 



Apprtcation 

Specific 
Components 



Local Rules 



Disconnected Data 
•t- Rules 




Query Engine 



Notification 



Bulk Edit 



XM Layer 



XM 



08 



C++ 



Figure 3. Configuration Architecture 
The model is expanded further in die drawing below. 



^ Supporting subsystems, such as the communications, are not shown. 
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Figure 4, Deployment View of Configuration Frameworlc 



The Client and Server Item Caches would have similar roles to the existing Lightweight layers but would be re- 
implemented a) to use Xml interfaces rather than DCOM and b) to push more functionality into frameworks. 

The DB load/save component would translate between Xml and XM calls. 

The load capability would be divided into loading of simple properties, whole items and special properties (that 
require significant Db processing and hence time). 

XM Services means things like Download, Verification and Import/Export that invoke considerable processing 
within the database, as used by the various Server legs in the DvDbServer. 

The XM Service Wrapper is merely a set of C# classes that wrap XM calls. 
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4.2 Client Component Framework 

4.2.1 Object Model 




The core of the framework is Component. It is broken down into 3 aspects, properties, children and 
commands. 

4.2.2 Properties 

Each Component contains a properties object. Properties can be loaded and saved independently of the 
component. Concrete subclasses of Properties contain members of type PropertyValue, this object 
encapsulates the value, whether it can be modified and whether it has been modified. 

On save; the properties that have been modified are sent back to the server. 

4.2.3 Children 

ChildCollection aggregates a series of ChildRoIes and implements loadChildren. Roles can be loaded 
Individually or en masse. When a role is loaded a filter can be applied. The properties of the child 
components can optionally be loaded at the same time. 

LoadChildren is called with a list of role descriptors that define exactly what is to be loaded. The 
framework is designed such that it can produce one query based on the supplied load criteria. 

Query results are merged with any previously loaded children. If more roles are request these are simply 
added. An existing role can be requeried with a different filter. In this event members of the role common 
to both filtered lists are preserved, while additions and deletions are made. 
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Figure 5 Client Components - LoadChildren 
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updateFrom 
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^ addChild 
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Figure 6 Client Components - MergeChildren 



4.2.4 Commands 

Each concrete subclass of Component connes with a CommandManager derived class. This class defines 
a series of methods that can insert the relevant commands into a command script. 

A CommandBullder class is used to create a complete command script that can be sent to the server. 
This allows a series of commands to be composed into one script. 
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Commands are given membership to one or more groups. Grouping is aimed at assisting the Ul in 
knowing which commands are valid in certain situations. 
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Figure 7 Client Components - Building a Command Script 
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4.3 Client/Server 



4.3.1 Connectivity 




Figure 8 Client Server Connection 

ServerConnection encapsulates the client side connection entity. It is used to establish a connection with 
the server and to send and receive information. The server equivalent for the ServerConnection class Is 
RequestBroker. This represents the client application In the server. 



ConnectionManager aggregates RequestBrokers and provides methods for interrogating and 
manipulating them from a client application. Host encapsulates the startup and shutdown code necessary 
to publish the .net remotable objects. 



Delegates are used to send back asynchronous messages from the server to the client. The results from 
asynchronous queries and commands come through AsyncResultDelegate. Database update 
notifications come through AsyncUpdateDelegate. The server Indicates to the client that it will be shutting 
down through ShutdownDelegate. 



Client/Server communication is established through a .net remoting channel. In addition to the standard 
top and http channels there will be a starbum channel. The starbum channel will use the DeltaV 
communication subsystem to reliably communicate information within a DeltaV system and between 
DeltaV zones. 
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4.3.2 Threading 



Unmanaged 




Figure 9 Server Threading Model 

ThreadManager holds onto 2 static references to ThreadPool. One for query (read) threads the other for 
comnnand (write) threads. A ThreadPool manages a number of ConfigThreads. At any one time some 
threads could be in use while others are available. 



If all the threads In a pool are in use the next request to getThread will construct and enqueue a 
WaitObject. When a thread completes its current activity it checks the wait queue. If a client is waiting that 
thread is given to the client. Otherwise the thread returns to the list of available threads. 



ConfigThread straddles 2 OS threads, the thread on which the request came in and the thread holding 
the database connection. All database access may be done on the latter thread. Further more the 
database thread may be a dedicated OS thread. The message can come in on any OS thread. 



To ensure the database calls into a database connection always occur on the same OS thread we do not 
use managed threads. Instead, we implement dual managed and unmanaged thread classes. 
ConfigThread derives from ManagedThread Handler which maintains a pointer to an 
UnmanagedThreadHandler. The latter class is able to start a real OS thread. The OS thread procedure 
simply executes the ManagedThread Handler's threadMain. This method sits waiting for a 'message 
ready* event. 



When a request is to be processed a MessageObJect Is constructed and store on the ConfigThread. The 
database thread is signaled to indicate a message is ready. Once the database thread has completed the 
task it stores the results on the MessageObject and instructs it to publish the results. If the request was 
sent synchronously the original thread on which the request arrived is signaled to indicate the results are 
available. This thread reads the results and returns to the client. If the request was sent asynchronously 
the message will have an associated AsyncResultDelegate which it can use to publish the results. 
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Figure 10 Get a thread from the pool 
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Figure 11 Prepare, Post/Send message 
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Figure 12 Process a message on the database thread 
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Figure 13 Release dalabase thread 



4.4 Query Framework 

4.4.1 Description 

The biggest change for clients Is the introduction of the Query Framework. A Query is written in C# and 
coded against the XM layer which is a thin veneer C++ layer Interface between the managed world of 
.NET and the unmanaged XM classes of HawkDB. 

The Query semantics allow the user to specify whether the request is to register with the database for 
updates. 

These query objects are very dynamic, A client asks for a query to be executed and gets the result as 
XML. The client request identifies the .net assembly and query. The framework loads the assembly if 
necessary and executes the query. This provides good decoupling of development paths. 

Direct services like import/export, navigation, download/upload could be implemented In this framework 
too. 

We store xml chunks in the cache. These chunks are loosely coupled by nature. The query objects 
created to load and save these xml chunks do nothing more. There's no business logic here. Now we 
produce/cache exactly the kind of data we want to transport around the system, ie XML. It's a flexible 
architecture that's extendable and can be molded by the client application writer to suit their needs. 

The Query engine is shown below. 
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Figure 14. Query Model 



4.4.2 Updating Queries 

To Improve the efficiency of saving changes to the database the query syntax could be extended to 
include property overrides. Thus executing the query would set object properties instead of reading them. 
This would be an alternative to submitting an update command script which would need to be compiled 
and executed. 

4.5 Command Framework 

Commands are submitted to the server in the form of JScripts. Each command Is compiled and 
executed. The scripts are coded against the Server Configuration Model. At this time the exact syntax of 
the scripts has not been defined. 

4.6 Service Framework 

At this time there Is specific service framework. The existing Client/Server model Is extended to add 
service capability. 

4.6.1 Import 

ServerConnectlon and RequestBroker are extended to include an import method that takes a managed 
stream and an ImportCallback delegate. 

In the server CommandThread is extended to include an import method. A new class ImportMessage 
derives from Message and Is used to communicate the stream and import callback to the database 
thread. The database thread calls import on the database connection passing In the stream and import 
callback. 

Inside the database connection the managed stream is wrapped in an unmanaged class that implements 
IStream. A pointer to this interface Is passed into the database code where the import actually occurs. 
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4.7 Server Configuration Model 

TO DO: Basic Framework model and explanation. 

Items 

Properties 

Roles 

Query 

Command 



The Configuration l\4odel that support the Query Engine is shown below. 




mm?m 



Figure IS. Configuration Model 
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4.8 Update Notification 



4.8.1 Object Model 




Figure 16 Update notification object model 



4.8.2 Register a Query 

The query syntax indicates update registrations on roles and items. The query below requests updates 
when the PlantAreas role is modified and when the properties of modules are changed 

Site. (handle) PlantAreas .Modules (handle) 

As the query processor executes the query it will register roles and items for update notification as It 
encounters them. 

There isn't a one to one mapping between role or item and a database object that can be registered for 
update notification. In some cases we may end up registering with a more general database object higher 
in the hierarchy. 

It is possible to register with the same database object multiple times, either by the same client or 
different clients. We may make a database registration once. Thereafter the same registration ID will be 
shared. The class Updatelnterest encapsulates the registration ID and a reference count. 

At the end of processing a query a list of Updatelnterests is returned to the RequestBroker. If this list is 
not empty we may create a RequestedQuery. This object stores the query and the latest version of the 
result. All the returned Updatelnterests are associated with the RequestedQuery. Each RequestedQuery 
has a unique ID that is returned to the client. 
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Figure 17 Execute a query with update registration 



4.8.3 Notify Thread 

The seiver runs a background thread to periodically process the list of changes. The processing is split 
into 3 phases. 

The first phase gets the list of modified IDs from the database and marks all the related RequestedQuery 
objects dirty. 

The second and third phases are deferred to the individual RequestBrokers. Initially the RequestBroker 
re-executes any queries marked dirty. By comparing the new results with the old we can determine 
whether the results have changed. 

Once all the queries have been re-executed the results from all those that have changed are combined 
into a single XML document and sent back to the client via the AsyncUpdateDelegate. 
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Figure 18 Notify Engine Execution 



4.8.4 Execute a Command 

After executing a command it is advantageous for the calling client to immediately receive any updates 
related to it. To achieve this behaviour a scaled down version of that which occurs In the notify thread Is 
performed. 

First the UpdateNotifier is asked to perform the mark phase of update notification. Then the second phase 
is performed for the calling application's RequestBroker . This re-executes all the registered queries. 

Finally the results from the queries that have changed are combined into a single XML document and 
return to the client synchronously with the result of the command. 
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Figure 19 Process the updates for a single client after a command execution 



4.8.5 Deregister a Query 

In submitting a query to the server containing update notification request(s) the client will receive a query 
ID. This ID is used to inform the server when the client is no longer interested In receiving updates on that 
query. 

When a server connection is shutdown the RequestBroker will forcibly deregister any queries the client 
may have forgotten to deregister. 

In deregistering a query we call release on each of the Updatelnterests associated with the 
RequestedQuery. If the reference count on an Updatelnterest goes to zero the interest ID is deregistered 
with the database and the Updatelnterest is released. 
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Figure 20 Deregister a query from update notification 
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1 Introduction 



1.1 Overview 

This use case document is an attempt to describe at a high level the use cases to 
configure a Gas Blend package in a Delta V system within the System architecture. 

1.2 References 

• System Configuration Workspace Framework document: An overview of 
generic configuration workspace. 

• Workspace Framework: An overview of a generic workspace. 

• System Technical Architectural: Discusses the System initiative and 
architecture. 

1.3 Terms and Definitions 

1.3.1 Equipment Class 

Defines the structure and behavior of something physical like a tank or a pump. 

1.3.2 Material Class 

Defines the properties and behaviors of a type material, e.g. Gasoline. 

1.3.3 Visualization Class 

A class that defines the visual characteristics of a physical object such as a pump or 
valve 

1.3.4 Process Library Item (PLI) 

A smart object that is composed of an equipment class and optionally, visualizations, 
a single control strategy and a single material class. 

Additionally, a process library item may contain instances of other process library 
items building up composite process library items 

1.3.5 Process Model View 

The view displayed when editing a process library item. 

1.3.6 Process Library 

A library in the DeltaV hierarchy, it contains PLI, visualization classes, equipment 
classes and material classes. 

1.3.7 Process Module Subsystem 

A subsystem that runs on a workstation or application station and it will have 
instances of optimizer function blocks. 
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1.3.8 Process Module 

A module that runs within a process module subsystem and it provides a higher level 
of control or optimization than the controller. Generally, process modules have highly 
specialized blocks to optimize a portion of a process. 

1.3.9 Optimizer Function Blocl^ 

Special function blocks that control parts of a process that are put in a process module 
and run in the process module subsystem, which resides in a workstation. FRS, third 
party integrators or even customers can create optimizer Function Blocks. 

1.3.10 Paclcage 

A package is a self-contained unit that encompasses a logical amount of work. 
Packages can b e b uilt u p t o c reate libraries o f functionality. A D eltaV System c an 
contain multiple packages. 

2 Configuration Workspace Overview 

When a configuration engineer, user, starts to configure a system they will start up the 
configuration workspace. A startup the workspace will have a main panel that the 
majority of configuration will take place. This is where the user will configure 
graphics, process modules, control strategies and the physical network. There will be 
a sub panel that is by default docked to the left. This panel will contain several items 
that may be in a tabbed window. One of the items will be the main DeltaV tab and 
will contain a tree to explore the DeltaV hierarchy in a manner similar to the current 
DeltaV Explorer. Items in this can be drag-dropped to main panel for the user to 
configure. A second tab will be items that the user has created in the current package 
such as» control module classes, process models, graphics, etc. Another possible tab 
will be the pallet of primitive graphics that come pre-populated with a DeltaV system 
as well as composite graphics that have been configured in the system. This could be 
the pallet and an explorer or browse view that the user can use for drag drop 
operations and side configuration. The packages created for this system will also be 
displayed under the packages tree item in the DeltaV Explorer tree. 

New systems will ship with a default package, DeltaV. Pre-populated items that ship 
will belong in the default package. Items can't exist outside of a package. New items 
that a user creates can be added to the default package, but the preference would be to 
create a new package maintaining a separation between default items and customer 
created items. A user or system integrator can create 1 to n packages. A package is a 
self-contained unit that encompasses a logical amount of work. Packages can be 
exported and imported as a unit into other DeltaV systems thereby adding value by 
building up a library of packages that can be reused. 

3 Use Cases 

3.1 Create a GAS_BLEND package 

User will start up the configuration workspace application. A tree will appear in a 
panel docked to the left or the right. The configuration workspace may appear 
something like the following picture. 
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User will select new package and enter "GAS BLEND". 

Results: A package named GAS BLEND will be created under the packages library 
item. The package will be empty except for the necessary pre-populated portions of 
the package. 

3.2 User creates a Meter PLI Item. 



In order to create the gas blend package the user determines that there is not an 
adequate meter and one must be created. 

3.2.1 User creates a Process Equipment Class 

First the user creates a new Process Equipment Class of type meter and enters the 
name METERL The main panel displays the properties pages of the meter and the 
user enters characteristics of this particular equipment and selects OK. 
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Process Equipment Class 
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3.2.2 User creates a Primitive Process Library Item 

The user then creates a process library item for the new equipment class and enters 
the name METER 1. The user selects properties and the main display will show the 
PLI properties pages. The PLI item is associated to the Process Equipment Class 
created above by drag-n-drop or by using the property pages. The user then associates 
an existing or new visualization or customizes an existing visualization. 
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The user decides that they will use an existing visualization and selects one from the 
Display class palette. If the user wants to customize this display in any way they 
create a new display class^. 

Finally the user associates a control strategy to the meter. The user decides that it is 
not necessary to create an entire module for the meter and that a PID block is 
adequate for control. Again, the user can do this by drag-n-drop or from the property 
page. If the user had decided to create a control module class they would have the 
option to open a new window in the main panel to edit the algorithm. 

The user wants to change some default values on the PID block to best represent the 
characteristics of the meter. The user selects Control strategy and the PID block is 
displayed as a new tab on the control strategy view, which displays as a new tab on 
the main panel. The user can override parameter values, create extensible parameters, 
and other actions that can generally be performed on a primitive function block. 

The user selects the "Save" command and the PLI and control strategy changes are 
persisted in the database. 

3.3 User creates a leg for the gas blend header 

The user will create a composite Process Library Item that will include several basic 
process library items. In this case the use is going to create a leg, which contains a 
pump flow meter and value and saved as a new Process Library Item under the 
DeltaV hierarchy and associated with the package. 

3.3.1 User create the Leg 

User selects new Process Model and then enters a name of LEG 1. An empty process 
model view is displayed within the main panel of the configuration workspace. By 
default a process model palette window will be displayed and will be rooted at the 
process library items in the DeltaV hierarchy. The palette window will be docked 
under the explorer tree as a separate tab but can be move to be a separate docked 
location. 

The result could look something like below 



The user may create a new display class or may override things In a display class. 
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3.3.2 User puts a pump PLI on the LEG 

The user will navigate the existing PLI items in the palette window and under the 
pump category, and maybe several subcategories, to select the correct pump identified 
on the PID drawing. The user drags the pump from the palette to the process model 
and gives it a name, generally the name that is on the PID drawing. 
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At this point the user has the option to take the default visualization or select a 
different visualization. The user can select an alternate visualization that is associated 
with the pumps PLI definition or the user can enters select a visualization from the 
visualization classes that is compatible with the pump's PLI deflnitions Process 
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Equipment class. This can be done multiple ways such as drag-n-drop or browsing, or 
editing the pump instance properties. 

- Visualizations 
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- External 
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When this occurs an additional visualization^ is created for that instance of the pump 
onLEGl^ 

The user then has a chance to override the Control Class for pump PMP-1 . In 
predefined PLI items a control class may or may not be defined. For simple items the 
control class may be a primitive block such as a DC block for a pump. The user will 
have the chance to override the control class^ and enter another existing block, or 
module class as well as create a new composite block or module class. The user 
mechanism for this will be the same as the visualization. However, one control 
strategy can be associated with a PLI. If the user changes the control strategy the 
change affects the instance of the pump not the pumps definition^. 

At this time the user decides that the existing control class is sufficient 



3.3.3 User puts a meter and valve PLIs on the LEG 

Now the user will put a meter, MTR-101, and valve, VLV-101, on the leg. The user 
follows the process above for creating a pump and to create a meter by choosing the 
meter created above and chooses a preexisting value from the library. 



* Process Library Items can associate to multiple visualizations and one control strategy 

Assumption is the pump on LEGl behaves similar to definitions and instances. An alternative would 
be to modify the definition or create a new defmition for the pump PLI. 

' Unlike visualizations, a PLI item definition and instance can be associated with one control strategy. 
^ Assumption is PLI items work like definition and usages. 
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3.3.4 User connects the smart items using a stream. 

At this time the user needs to connect the smart items (PLI) on the process model. The 
user navigates to the palette with the streams, which are a specialized PLI types, and 
selects an 8" stainless steel pipe with XYZ characteristics. The user then selects the 
out connector from the pump and drags the mouse to the in connector of the meter. 
The result is an instance of tiie pipe stream is created which connects the pump and 
meter. 



Q 



VLV-101 
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Also, the user wants to expose an input and output to the leg to be used on the header. 
To accomplish this the user will create another stream but connect the output 
connector to the input connector of the pump. Then the user will select the input 
connector on the stream and change its properties to public. The process will be 
repeated for the output but the stream will be connected to the pipe. 




PMP-101 



o 
o 



VLV-101 



3.3.5 Engineer exposes properties as public 

The configuration engineer wants to expose additional properties of the leg as public. 
The configuration engineer selects the meter and the properties of the meter are 
displayed in the property window. (This is another window that will be docked or 
tabbed within a docked window). The user selects the PV of the meter and selects new 
external interface with a name of FLOW_RATE_PV. The user selects the SP and 
creates a new external interface FLOW_RATE_SP, Additionally, the user wants to 
expose the value position as a read-only public interface this done the same way 
except the user designates this public property as read-only. 

At this point the user selects save command, which persists the process model 
changes into the database. 

3.3.6 Engineer generates default visualizations and control 
strategies 

Now the user wants to group the pump value and meter together. This is given a loop 
tag of FCC- 101 . The user then selects the Generate Command. The generate step will 
create a default control strategy. In this case a Control Module Class will be generated 
with a name of FCC-101 . If any of the smart object's (PLI) control strategy had been 
a module the results would be an Equipment Module Class. In this case the Control 
Module Class will use the designated control strategy blocks defined for the pump 
(DC), valve (PID) and meter (AO) to generate the control module. 
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In addition, die generate command will create visualizations for LEGl^. There may 
be one or more visualizations generated. This will be based upon the visualizations 
that are associated with the PLI instances on LEGl. Some examples are detail 
operator display class and overview displays class, and faceplate display class. 

The generated module class and display classes will be associated. The operator 
display will have links to the control strategy, faceplates and other objects, which will 
have links back links to the original objects. 

At this point the Hierarchy view displays the control strategy and displays under 
LEGl in appropriate categories and additional menus and toolbars are enabled. The 
configuration engineer can then select to edit the generated control strategy. In the 
main display a new tab appears and the Control Module Class appears. The Process 
Model is hidden but easily accessible as another tab on the main display. 

The user then can edit the control strategy as necessary^. The configuration engineer 
will then be able to save the Control Strategy (Control Module Class). 

The Control Module class will appear in the GAS_BLEND package and the overall 
DeltaV hierarchy under the Advanced Definition / Control Class /Module Classes and 
under LEGl. 
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3.3.7 User customizes generated leg display 

The configuration engineer wants to modify the generated display for the leg. The 
engineer selects to edit the display. The main panel in the configuration workspace 
displays a new tab and the previously generated Operator Display is shown, A 
display editor palette is shown which is the toolbox of graphic items for the display 



' In some cases the such as faceplates there may be nothing to generate Just the tag needs 
associated to the correct faceplate template 

° The generated control strategy and displays may be loosely coupled. If the user changes 
the process model the control strategy is not updated until a regenerate is performed. 
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editor. This is either as separate docked window or as a tab within the explorer 
window^. 

The engineer decides that some of the generated graphics need adjustment. The user 
selects the detail display graphic and moves it to the desired location and additionally 
changes some of the properties of the selected graphic. Then the user adds a document 
visualization, which is then linked to a foreign document that contains the operation 
procedures for this leg. 
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The user selects the save command and the display is persisted in the database. 

The user then closes all items in the main panel, control strategies, displays and 
process model views, etc. 



3.4 User Creates a GAS BLEND Header 

The user wishes to create a process library item (PLI) to represent the header of the 
gas blending. The header will be made up of 8 instances of LEG 1 created earlier. 



3.4.1 User Creates PLI HEADER1 

User selects new Process Model and then enters a name of HEADERl . An empty 
process model view is displayed within the main panel of the configuration 
workspace. By default a process model palette window will be displayed and will be 
rooted at the process library item in the DeltaV hierarchy. 



3.4.2 User added instances of LEG1 to HEADER1 

The engineer navigates to the PLI item LEGl that was created earlier. The user then 
drag-n-drops an instance on the diagram and for now accepts the default instance 
name LEG1_1 . The leg is rendered as a function block, unless the user has assigned a 



^ Note: All docked windows wili have the ability to have multiple tabs. 
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graphic for the leg. There will be an input and output connector which represent the 
exposed portions of the stream. Additionally, when the LEGl instance is selected the 
property window will display the public properties LEGl such as FLOW_RATE_CV, 
FLOW_RATE_PV and FC-lOl/SP. 

The engineer within the process model view selects the leg and copy/pastes 7 
additional instances named LEG1_2 to LEG1_8. The engineer then using in-place edit 
renames the legs to the appropriate names for the GAS BLEND header***. 

The new names of the legs are: 

• REFORMATE 

• THERMALLY_CRACKED 

• CATALYTICAL^CRACK 

• POLYMERIZED 

• LSR 

• NBUTAIN 

• ALKYL 



3.4.3 User connects lets together with extensible STREAM 

The engineer then ties these together with an extensible stream. The engineer using a 
drag-n-drop, typing or a wizard creates a stream with a default name STREAM 1 . The 
engineer selects the stream and indicates that this stream has 8 inputs. The stream is 
redrawn with 8 inputs and one output connector. The user then rearranges the stream 
to create waypoints to allow the stream to be represented as a series of horizontal 
inputs and a vertical section and a horizontal output. At this point the user attaches 
the legs to the stream inputs' 

Then the engineer creates a mixer tank for the header. At this point the user decides to 
navigate the Process Model view's palette and select the appropriate mixing tank from 
the mixing category. An instance of the PLI item is created with a default name of 
TK-iOI . The user decides to rename this to TK-MIXERl . The output of the 
STREAM lis attached to the input of the mixer tank TK-MDCERl . The mixer tank is 
a simple tank and has a control strategy associated of a DC block since a paddle that 
is controlled by an integrated motor does the mixing. 



The result may look something like the figure below . 



May be INI to 1N8 and renamed at when the feed tanks are attached. 
Possible that attaching multiple inputs to a stream automatically creates additional inputs on 
the stream 

Leg instance will show as a function block if there is no default visualization. Most likely the 
visualization represented when creating other PLI item may be the overview display generated. 
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3.4.4 User exposes connectors In header 

The user exposes the public connectors and public properties of HEADERl. The user 
multi-selects the public inputs on the 8 LEGl instances as well as the output 
connector on the TK-MIXERl and designates those as public. The public connectors 
may be shown in a different color such as blue. Users of the HEADERl will see 
connectors named REFORM ATE_IN, NBUTAIN_IN etc. 



3.4.5 User save and generates control strategy and displays 

The user then saves the process model view. The user then generates a default control 
strategy. The control strategy generated is an Equipment Module Class (EMC) named 
HEADERl^EM since the definition of LEGl's control strategy is already a module 
class. 

The user then requests to generate a display class for the HEADERl. The display 
class is named HEADERl. By default operator display classes that are generated will 
have links to other operator display classes for each public input and output 
connector. For example, the HEADER_DISP will have links to the LEG_DISP 
display class. When the operator is drilled into the LEG there will be a link back to 
the correct header instance. 

3.5 The user creates GAS BLEND Process Module Class. 

The user has now created several building blocks for the gas blend system. These are 
all class-based items in the process library. The user is now ready to create a Process 
Module using the items created before and the optimizer's blocks for blending gas. A 
process module will run within a workstation not the controller. 
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3.5.1 User creates a Process Module class 

The user navigates to the Process Module area of the Delta V Hierarchy or the 
GAS_BLEND package hierarchy. The user then creates a new Process Module with 
the name of GAS_BLEND_PM and with an algorithm of "optimizer". 

3.5.2 User adds PLI instances to Process Module class 

The user chooses to add an instance of the PLI item HEADER 1 . The header one 
instance appears on the process model view as a block with the 8 inputs and 1 output 
displayed ^ The user renames HEADERl^l to GB_HEADER. The user then creates 
a feed tank. The user selects a feed tank from an existing tank category in PLI section 
of the library. The feed tank by default is named TK-101 . The user creates a level 
indicator, LIl for the tank and exposes the capacity property for the tank as public'"*. 
Finally, the user then creates a stream by selecting a stream PLI and attaches it to the 
output of the TK-101 and to the REFORMATE_IN on the GB^HEADER. This tank 
is copied for the other 7 feed tanks, TK-102 to TK-108 and attached to the header. 

The user then creates blend tank by dropping an existing tank PLI and names it 
TK_BLND. The user then creates another stream and attaches the stream to the output 
of the header, GB_HEADER to the input of the TK-BLND. 

3.5.3 User adds PLI instances placeholders 

At this point the user needs to offer some customization to the GAS_BLEND process 
model. The configuration engineer realizes that some implementations a booster 
pump will be needed one or more of the feed tanks TK-101 to TK-108. The user 
creates a pump and drops it on the stream. Using some special control key such as the 
control shift the user is able to automatically insert that into the existing stream and a 
new stream is create and the in and out connectors of the stream and pump are 
automatically connected. The user renames the booster pump PMP-101 to PMP-108 
(not shown). The user marks these as placeholder item, that is a piece of equipment, 
which may might not exisit in a customer's plant. 

3.5.4 User adds Gas Blend optimizer blocks 

Now the user needs to create instances of two gas blend optimizers for the gas blend 
algorithm'^. The user navigated to the optimizer's category within the DeltaV 
hierarchy. The user expands the "GAS BLEND_OPT" optimizer category and drags 
an instance of the Flow/Ratio Control optimizer to the Process Model. The user then 
drags Volume Control optimizer. These are represented as function blocks on the 
process module and are named FRCl and VCl respectively. 



Note: the representation of the PLI Item can be changed from a block to anything by 
associating the PLI items to a visualization class 

^* The user would probably create a composite PLI with the tank and level control and create 
8 instances on the GAS_BLEND process module. 

It is believed that the optimizer function blocks are somewhat similar to primitive function 
blocks. They are not created and configured via the DeltaV configuration workspace but are 
standalone plug-ins that run within a Workstation's Process Model Subsystem. There is a 
loosely coupled representation of them in the database for configuration of process modules. 
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The user then associates the FRCl to the input of the GB_HEADER and the to the 
mixer within the GB_HEADER"'. The user then associates the volume control with 
the blend tank and the FRCl optimizer block. 

The user then associates the optimizers with the input tanks level indicators LIC-101 
to Lie- 108, the instances FLOW_RATE_PV and FLOW_RATE_SP outputs of the 8 
legs and the blend tank level PV. This is done so the optimizer can determine if there 
will be sufficient feed stock for the blend operation as well as if flow of a leg is 
unable to reach the set point, pacing would be required. If insufficient feed is 
unavailable the optimizer may be able to use an alternate combination of feed, which 
may not be most cost effective but still result in a product that is in specification. 



3.5.5 User save and generates 

The user saves this to the configuration database and the GAS_BLEND process 
module is updated. 

The user then selects to generate the control strategy and operator displays. An 
equipment module class GS_BLEND_EM is created and will control the 
GS_HEADER_EM equipment module class as well as control the interaction with the 
optimizer function blocks. The operator display class is created named 
GS_BLEND_DISP and it will contain graphics of the feed tanks, header and blend 
tanks as well as a graphical representation of the optimizer blocks, which run on a 
workstation. The operator display that is generated will by default have links to the 
GS_HEADER display class, the Equipment Module GS_BLEND_EM class. 
Additionally, the graphics such as the tanks and even the header will have the links to 
the faceplates, which will be class/template based and data driven therefore will not 
require any user configuration. These will be saved in the appropriate location in the 
DeltaV and GAS_BLEND package hierarchy. 



This requires certain parts of the mixer to be public within the header. 
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3.6 Engineer Create an Instance of GS^BLEND 



The engineer would like to test the GS_BLEND package. To do this an instance of the 
gas blend package may be created and assigned to a controller (or workstation if 
simulating). 

The user then creates an instance of the GAS_BLEND process module by navigating 
to AREATA and selecting new process module instance. The user is able to browse to 
the process module classes and chooses the GAS_BLEND process module class. At 
this time the system generates many module and display instances at that time. For the 
GAS_BLEND model the following hierarchy will be created. 



instances 
Control Strategies 
AREATA 

GAS_BLEND_1 
Module 

GAS_BLEND_EM_1 
Module 

GS_HEADER_1 

Module 

REFORMATE_1 

Module 

THERMALLY_CRACKED_1 

Module 

CATALYTICAL_CRACK_1 

Module 

POLYMERIZED_1 

Module 

LSR_1 

Module 

NBUTA1N_1 

Module 

ALKYL_1 

Module 
Displays 
AREA A 

gas1blend_disp_i 
gs_header_disp_1 
reformate_1 
thermally_cracked_1 
catal yti cal_crack_1 
polymeri2ed_1 

LSR_1 

NBUTAIN_1 

ALKYL.1 



Definition Type 

GAS_BLEND Process 

GAS_BLEND_EM Equip 

HEADER1 Equip 

LEG1 Control 

LEG1 Control 

LEG1 Control 

LEG1 Control 

LEG1 Control 

LEG1 Control 

LEG1 Control 

GAS_BLEND_DtSP Display 

HEADER1 Display 

LEG1 Display 

LEG1 Display 

LEG1 Display 

LEG1 Display 

LEG1 Display 

LEG1 Display 

LEG1 Display 



In some extremely complex scenarios, it may take a few minutes to generate the 
instances. While the instances are being generated the user will not be blocked and 
have to opportunity to perform other work such as commission a controller, enable 
card channels etc. 

After the instances are created the main panel will display a table view of the gas 
blend instance with the public and exposed properties visible. The engineer will then 
be able to override the public properties such as I/O assignment, gains» alarm limits 
with in-place edits. 
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The engineer will also be able to display the properties of the GAS_BLEND1 instance 
or subordinate instances by selecting the property command. This creates a new tab 
within the main display and is a modeless dialog or displayed as a specialized docked 
window on the configuration workspace. At a minimum this should not be modal to 
all other to select other objects in the hierarchy and see their properties without the 
multiple steps to cancel the current property dialog and bring up a new property 
dialog. Some examples of the properties that might be overridden the size of the 
stream, pump capacity for the legs, if booster pumps exist or not. 

The user then assigns the process module to a workstation that has the process module 
subsystem enabled, valid nodes are the ProPlus w/s or an Application station. 
Additionally, the user assigns the modules to a controller, or w/s if in simulate mode). 

3.7 Engineer downloads the GAS_BLEND instance 

If the engineer decides that they need to download the entire system since nothing has 
been downloaded then the engineer can simply download the Physical network. This 
will download the process module, equipment and control module instances and 
operator displays. 

If the engineer decides that the would like to download the GAS_BLEND module 
and subordinate modules as well as operator displays the user will select the 
GAS__BLEND_1 instance in the Control Strategy/ AREA_A and choose download 
additionally, the user will select to download the GAS_BLEND_DISP under the 
Displays/AREA_A location in the DeltaV hierarchy. 

When downloading is initiated a wizard will appear as a new tab within in the main 
panel. This will be a modeless window and the user can navigate to other windows 
without dismissing the download dialog. The user will navigate the wizard and initiate 
the download. After all the questions have been answered, and the download is 
generating or progressing, the user will be able to select another tab in the main panel 
or open up other items from the main DeltaV tree. The user will not be blocked at the 
UI will the download is progressing. 
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3.8 Engineer debugs an instance of GAS^BLEND 

The engineer wants to debug the instance of the GAS_BLEND process model that has 
been created and all associated equipment and control modules, operator displays and 
links within the operator displays to other displays, control strategies and faceplates, 
and advanced control systems. 

The engineer has successfully downloaded the GAS_BLEND configuration. The user 
selects the GB_HEADER_1 equipment module instance within the gas blends system 
and selects debug option. The control strategy for the class appears in the main panel 
in a debug mode with values updating. From the GB_HEADER_1 module instance 
the engineer is able to navigate to the parent and/or child module instances with a 
single mouse click, navigating or browsing is not necessary. 

The engineer would like to test the operator displays for the G AS^BLEND 
configuration. The engineer could navigate to Displays/ AREATA and select a display 
and select RUN. Conversely, when debugging a module instance the engineer can 
select operator display and the operator display will be run and allow the user to see 
the values from the display. 

If the engineer decides to test an operator display instance the engineer can select 
"RUN" command and the display will be brought up in the "Operator Workspace", 
with values updating on the display. If the display has script or function blocks on it 
they can be debugged with breakpoints in the configuration workspace and the 
engineer can step though the script for an object or display event. When debugging an 
operator display instance the engineer can select the links to other operator displays as 
well as the linking to view online a control strategy that is associated with the object 
selected or the overall display selected. 

Additionally, there is one other way the engineercan run a strategy or display online. 
The engineer can have a display class and select run. The user can then enter an 
instance and run that instance. Same thing should be possible for a module class. 
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3.9 Engineer exports the GS_BLEND package from DV 
System. 

3.10 Engineer Imports the GS_BLEND package in a DV 
System. 
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1 Introduction 



This document describes the communication architecture for the system. 

1.1 Starburn Communication Objectives 

1. Provide a Communication Infrastructure for all system applications 

2. Support Connected as well as Wireless Connections 
3. 



1.2 Supported Topologies 

1.2.1 Small System 



Applications 

- Configuration 
• Operator 
-Batch 

- Advanced Control 
-etc 



Client 
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Figure 1. Small System 
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1.2.2 Large System 
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Figure 2. Large System 



1.2.3 Multi-Zone 
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Figure 3. Multi-Zone System 
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1 .2.4 Remote Client 
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Figure 4. Remote Clients 

1.3 Scenarios 

1 . Configuration 

• Connect to Server - Explorer to located and connects to DvDbServer 

• Expand Area 'AREATA* 

• Updates are returned to a client 

• Starbum Server foils over from Active to Standby 

2. Batch Executive 

• Save Graphic ' 

3. Diagnostics 
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2 Requirements 



2.1 Topology 



2.1.1 Small 

• Can host up to 

• 4 Starburn Client Nodes 

• 4 Controller or Old Style Operator Nodes 



2.1.2 Large 

• Can host up to 
• 120 total nodes (in any combination of the following) 

• 60 Starbum Client Nodes 

• 60 Old Style Operator Nodes 

• 1 00 Controller Nodes 



2.1.3 Zones 

• Can support up to 64 Zones 

2.1.4 Remote Client 

• Can connect to one Zone at a time 

• May have a direct communication path to each Zone (hopping may not be supported) 

2.2 Support Configuration Clients Talking to Server 

• Local - on ACN (can use .NET Remoting) 

• Remote — outside ACN (can connect to one System at a time) 

• In another ACN (i.e. Zones) 

• Browsing (use .NET Remoting) 

• Transfer the configuration hierarchy (use .NET Remoting) 

• Full configuration (use Terminal Services) 



2.3 Support Configuration Services 

• Download (control strategies and displays) 

• Upload (control strategies and displays) 

• Status information (e.g. Node is downloaded) 

• Commissioning 

• Debug 

• Diagnostic Information 

• Session Support 

• Who is logged on 

• What rights does the logged on user have 

• Licensing Support 



2.4 Directory Service 

• Object Location Transparency 

• Nodes 

• Modules 

• Displays 

• PI Data 

• Batch Data 
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Localization Information 



2.5 Connection Manager 

• Forms connection over local networking 

• locally it would over our .NET channel service 

• between Zones it is over our .NET channel service 

• to Web devices it will be HPPT Post messages over SOAP (similar to what was done in the 
prototype) 

• Report failed connections 

• Report failover to backup services 



2.6 Redundancy 

• Communications switchovers (transparent to the client applications' - this is covered under "Object 
Location Transparency", we change the source location of an object w/o the client having to be 
involved) 

• Starbum Server Node switchovers (Active-to-Standby switchovers - may require clients to be 
notified and they in-tum to initiate some action such as "retry*') 

2.7 Object Brokering Service 

• Look up system services (e.g. DvDbServer is on node *X', node * V supports DvHistServer, etc) 

• Given a service, what docs it support. 



' Communication switchovers may not be transparent to some of the applications. In some cases the application 
may need to know about the switchover. 
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3 Data Services Concept 



3.1 Overview of Concept 

Starbum will provide low level services that can be used by multiple data providers. The low level 
services take care of connections, sessions, redundancy, retries, timeouts, etc. The general model 
for these services is summarized below: 




HIctDfySlndiRBA 
OPCBindngi 



Figure 5. Integrating Multiple Data Providers 



3.2 Service Providers 

The service providers for the Clients will consist of: 



1. 


Runtlme Data 


2- 


Historian 


3- 


Alarms 


4- 


Events 


5- 


OPC Data Services 


6- 


XML Files 


7- 


HTTP Links 



Each of these services will have a very specific interface defined for it. System Services 
implementing these services will follow the service interfaces. This allows clients to remain constant 
even when services are swapped out. For example, as part of the DeltaV and Ovation installations, 
the Service Providers will be Installed. 
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4 Process Graphics Scenarios 



4.1 Background 

The Process Graphics Display environment supports interfacing with multiple data services. This was 
discussed in the data services concept. For Process Graphic Displays the support would be provided 
as illustrated below: 




Figure 6. Integrating Process Graphics With Multiple Data Providers 
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4.2 Runtime Data Scenarios 
4.2.1 Initialization Scenario 

4.2.1.1 Preconditions 

1- DeltaV Sen^ices Started 

2- Display Package Loaded 

3- User not logged In 

4.2.1 .2 Postconditions 
1- User Logged in 

4.2.1.3 Scenario 

1- User selects option to tog into DeltaV 

a. A dialog is presented to log into DeltaV 

b. System prompts for User Name and Password 

c. User enters User Name and Password 

2- Process Graphics Client requests a session handle by calling 
"LoginrUser^,"Password",'^SessionH) on Display Server 

3- Display Sen/er checks for an existing channel by calling LocateChannel 

4* Display Server creates a channel to DvDataServer by calling 

CreateRemotlngChannel("Starburn::DvDataServer",'^Channel) on DvDataServer 

5- Display Server requests a session for the user by calling 
LogOn(Chann6l.''User,"Password",^ISession) 
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4.2.1.4 Object Collaboration Diagram 



1 ijotfnniMr'.'Passwanr /SessionH) 



ii::OvOat»Seiv«f*.*ChBiin«l) 




S±ooOn(Cltannet.^Js•r'.-PBssMOld*.M^lBonSta^ul.^S«sstM) 



4.2.1.5 Component Sequence Diagram 



Pass user name and password to 
authentication service 

Authentication service validated the 
logon request, create an instance of a 
DeltaV session dass for the user 

New Statement 



« interface » 
«remoting» 
Authonticat ion Service 



:PisplavServicQ PiHigV'^ tlJIIiiMPAfmCTgSnWgngB 



logOnUser 



LogOnUser 



4.2.2 Load Display, Add Group & Item 

4.2.2.1 Preconditions 

1- Process Graphics Package Loaded 

2* User has a session handle allocated 

3- User has just browsed and requested Process Graphics Client to load Display "DISPI" 

4.2.2.2 Postconditions 

1- Display "DlSPr loaded 

2- Data Fields in ''DISPr have been bound 



4.2.2.3 Scenario 

1- Process Graphics Client requests display to be loaded by calling 
LoadDisplay(SesslonH •DISPr.'^SVG) on Display Server 

2- Display Server requests a Display Service by calling 
CreateDisplaylnterface(ISession,'^IDisplayServlce) on Display Server 

3- Display Server requests display by calling ReadDisplay(ISession,''DISP1",'^XML) 

4- Process Graphics Client processes XML file. Rt Data Bindings are bound by calling 
AddGroupsAndltems(SessionH.RtDataBindings.'*lnitialRtValues) on Display Server 
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5- Display Server sends request AddGroup(UpdateRate,SlngleFlelds,^IGroup) to DvDataServer 

6- DvDataServer sets up DeltaV communications 

a. Sesslon::Locate(^RTSecureModule) 

b. CreateAccessToken(^AccessToken) 

c. OCNiiBlndAccessTokenC^RT^SUCCESS) 

7- DvDataServer adds Items to group by calling Addttems({items},^{ltemH}) 

8- History Data Bindings are bound by calling 
AddHistorytems(SessionH,HistDataBindings,A|nitlalHistVatues) on Display Server 

9- Display Server sends request AddHistoryltems({HistDataBindings}/{ltems}) to DvHistServer 

10- XML File Bindings are bound by calling 
AddXMLItems(SesslonH.XMLFIIeDataBlndlngs.''lnltialFileVatues) on Display Server 

11- Display Server sends request AddHistoryltems({HlstDataBindings}.'^{ltems}) to DvHistServer 

12- Process Graphics Client Renders Display 
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4.2.2.4 Object Collaboration Diagram 




4.2.2.5 Component Sequence Diagram 



Load Display -Displ- 

Create a change notification aroup for 
■DIspr 
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For oacti item in the display 
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End Itemtion 
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4.2.3 Receive RT Data Change 

4.2.3.1 Preconditions 

1- Group and Data Items has been set up 

2- An item has changed in DeltaV 

4.2.3.2 Postconditions 

1- Update has been processed 

4.2.3.3 Scenario 

1- DeltaV System sends a DataChanged() request to DeltaV Core Workstation Services 

2- DeltaV Core Worlcstatlon Services sends a OnDataChange(ltem) notice to DvDataServer 

3- DvDataServer gets current data value by calling ReadData(ltem,^Data) on DeltaV Core 
Workstation Services 

4- DvDataServer checks to see if data value has really changed 

5- If the data has changed a event Is raised by calling 
IGroup::RaiseDataChangeEvent(litem,NewValue) on DisplayServer 

6- DisplayServer passes data value on to Process Graphics Client 

7- Process Graphics Client Renders Display 
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4.2.3.4 Object Collaboration Diagram 
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5 Configuration Scenarios 
5.1 Background for Scenarios 
5.1.1 DvDvServer Connection Model 

The connection model used by Starbum wilt contain the services illustrated in the following drawing. 
The exact methods and naming are being worked out. 



appficcUonNania 
««iviccHo9tNafne 



donctK/ste 

getUstOfCormections 

«xsoutfOuory 

flXOCUtoCofnnianJ 



J 



UpdatBUstBn«rsO«la«ats 



0v0b8*rR«qu»tt8ralwr 



UpdstsU stan*r«0«l«9at« 



Figure 7. DvDbServer Service Connections 
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5. 1 .2 Sample Hierarchy 

Several of the scenarios make use of the following hierarchy: 
Site 

+ Library 
System Configuration 
Recipes 
+ Setup 
Control Strategies 
+ AREA_A (Area) 

♦ LINE_1 (Process Cell) 

+ BOILER.A (Unit) 

+ WATERJNLET_FLOW (Equipment Module) 
+ VALVE.I (Module) 
+ FLOW_METER_1 (Module) 

AM -> FFAI1 
+ PLM_1 (Phase Logic Module) 

+ Physical Network 

+ Control Network 
+ CTRL1 

+ I/O 

+ C01 

+ CH01 
+ CH02 

+ C01 

+ P01 

+ PDT1 

FFAI1 
FFAI2 
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5. 1 .3 Component Hierarchy 

The scenarios in the following sections make use of several new components and interfaces. These 
are Illustrated below. 




Figure 8. Component Layers 
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5.2 User Starts Explorer 



5.2.1 Preconditions 

1- Explorer is not started in Ihis* node 

2- No other configuration applications are running on this node 

3- A Starburn Server exists 

5.2.2 Postconditions 

1- Explorer has been started 

2- A .NET Remoting channel has been set up between the Client 'EXP' and the Server 
•DvDbSen/er* 

5.2.3 Scenario 

1- User selects Start Menu->Starbum->Engineerlng>>Exp]orer {not sure what the navigation wiif 
ultimately be, for now assuming classical navigation) 

2- Client 'Exp' creates Connection Object *DvDbServer_Client' ( probably executing something 
like DvDbServer_Client « new DvDbServerServerConnection (string "Zone*, string 
«SB^PRO+'', service "DvDbServer") ) 

a. Connection Object 'DvDbServer.Client' requests a channel from Connection 
Manager 'ClientConnectionManager' 

b. Connection Manager 'ClientConnectionManager' contacts Directory Services to 
locate service 'DvDbServer' 

c. Directory Services retums address information for service 'DvDbServer' 

d. Connection Manager 'CitentCM' sends message to Connection Manager 
*PROPIusCM' to allocate channel 

i. Connection Manager 'PROPIusCM' allocates channel 'CH_1 ' 

ii. Connection Manager 'PROPIusCM' returns channel •CH_1' to Connection 
Manager on 'ClientCM' 

e. Connection Manager returns channel *CH_1' to Connection Object 
*DvDbServer_Cllenr ' 

3- Client 'Exp' activates Server Connection ( probably by executing something like 
DvDbServer_Client.Activate( channel "CH.l" ) ) 

5.2.4 Component Sequence Diagram 
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5.3 Next Scenario 

5.3. 1 Preconditions 
1- E 

5.3.2 Postconditions 

1- A 

5.3.3 Scenario 
1- u 

5.3.4 Component Sequence Diagram 
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6 Data Services Architecture 



6.1 Overview 

The technical architecture for data services delivers the technical components and franneworks that 
support what we are trying to build. 

6.2 Component Architecture 

The drawing below illustrates the initial component map after the exercises executed above. 
Packages have been added to represent the logical components. Most components have an 
interface added to provide services. 




Figure 9. Component Architecture 
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6.3 Subsystems 

Subsystems provide a high-level view of how the architecture realizes Use Cases without going into 
the low-level details. The concept of subsystems sometimes carries through to Implementation in 
which case real components implement the subsystem. 



The subsystems below are a partial list. The list summarizes what I thought about as I assembled the 
minutes from the architecture document. 



Subsystem Name 


Subsystem Description 


Operator Woritspace 


Provides a controlled environment for Process Graphics. Batch Operator 
Interfaces. Advanced Control Applications. Alarm Banner. Alarm 
Summary. Faceplates, Detail displays, History Clients, etc. 


Engineering Workspace 


Provides a controlled environment for Configuring Process Graphics. 
Batch, Advanced Control, Alarms, Displays. Devices, History, etc. 


Process Graphics 


Provide user defined views and operator interfacing onto the system 
architecture. 


Ul 


Provides Specific Controls, Frameworks for application developers. Ul 
design guidelines, etc 


Configuration 


Provides configuration services for both connected and disconnected 
clients. Connected clients include applications to configure control 
strategies, displays, lO, user accounts, manage configuration, load 
licenses, etc. Disconnected clients are used for bulk editing the system, 
Tor iniGrracing lo exiemai loois sucn as iimioois, anu lor duurtsooiiiy 
customer specific requirements with respect to Recipe Management, etc. 
Also includes services for Versioning and Audit Trail, 


Communication 


Provides communication services for control, debugging, configuration, 
alarm & alerts, operator interfaces, etc. 


Data Services 


Provides low level access to the system. This consists of things such as 
the Custom Function Block interface for interfacing foreign DCS systems 


nn 


Prn\/iHp ^tinnort for user loaon session manaoement secure access to 
the system, and span-of-control. 


Events / Alarm / Alert 


Allows monitoring and notification of significant system states. 


Licensing 


Provide services to enable functionality on the system using licensing. 


Diagnostics 


Interacts with alt of the subsystems to collect diagnostic and alert 

information. 


System Administration 
Services 


Provides services for installing applications and hot fixes. Also provides 
support for remotely monitoring and supporting systems. 


History 


Provides access to continuous, event, and batch data. 


Control 


Provides continuous, sequencing, batch, recipe, process, safe control. 


PIO 


Provides access to all of the lO - including conventional lO. Fieldbus. 
Profibus. DevlcNet. Serial. ASi. Remote lO, RS3 lO, Provox lO, Safe lO, 
etc. 


Report Writer 


Provides reporting services for alarm/alert information, document 
configuration, etc. 
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7 Communication Services 



7.1 Overview 

The communications subsystem with it's supporting frameworks are illustrated below. 



CSent Busbiass Rulat 



C6«nt Components 



Alaims & Aleru 



C++ / C* manasod inteiftce 



I c 



Alann. Kistoiy. othsr sofvices 



Figure 10. Deployment View of Communication Frameworic 

The... 



7.2 Communication Frameworic 

7.2.1 Description 

The biggest change for clients is the introduction of the communication assemblies and 
components... 

The communication framework is shown below... 



Figure 11. Communication IViodel 
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The Configuration Model in more detail is shown below. 

Figure 12. Conflguration Model 



7.3 Communication Services 

7.3.1 Download Service 

7.3.2 Upload Service 

7.3.3 Passtlirough Service 

7.3.4 Commissioning Service 

7.3.5 Debug Service 

7.3.6 Diagnostic Service 

7.3.7 Session Service 

7.3.8 Licensing Service 

7.3.9 Status Information Service 
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8 Session Services 



8.1 Overview 

The 



Tit 
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9 Directory 

9.1 Overview 

The 



10 Connection Manager 
10.1 Overview 

The 



11 Redundancy 

11.1 Overview 

The 



12 Object Brokering Service 

12.1 Overview 

The 



13 Communication Services 
13.1 Overview 

The communications subsystem with it's supporting frameworks are illustrated below. 
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14 Communication Services 
14.1 Overview 

The communications subsystem with it*s supporting frameworks are illustrated below. 
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System Globalization and Localization 
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1 Introduction 



1 .1 Oven^iew 

The NET Framework provides extensive support for the development of worid-ready applications 
The NET localization model consists of a main assembly that contains both the application code and 
the default resources (strings, images, objects, etc) in English. Each localized application will have 
satellite assemblies for each specific locale that will be supported by the application. In the localization 
model, resource fallback, or the loading of the con-esponding resources, happens in a hierarchical 
manner 

• At the top of the hierarchy sit the default resources contained in the main assembly. This is 
the eventual catch all for resource searches. 

• Below the default resources are the resources for any neutral cultures. 

• Below the neutral culture resources are the resources for any specific culture. 

When a localized resource such as a string is loaded and is not found, the hierarchy will be traversed 
until a resource file containing the requested resource Is found. This Is best Illustrated by the figures 
below: 




1) Application tries to load Swiss 
German specific resources 



2) Swiss German specific resources 
not found; application is redirected 
to English Default resources 



Figure 1 . 1 . 1 . Neutral culture not specified 



3) Neutral German specific 
resources not found; 
application is redirected to 
English Default resources 




Figure 1.1.2. Neutral culture specified 



1) Application tries to load Swiss 
German specific resources 



2) Swiss German specific 
resources not found; 
application is redirected 
to German neutral 
resources 



Since the localized satellite assemblies contain resources and no code at all, they can be compiled 
and translated at any time. Translation could be done parallel to development or even after the 
application has shipped out. 
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The Starbum project will leverage on this localization model by providing a localization framework that 
will be followed throughout the project's lifetime. The Starburn modules will be designed and 
developed as a globalized application and localizability testing will be integrated into the testing 
framework. Finally, a localization toolkit will be provided to allow clients and/or third-party translators 
to do the actual localization or translation work. 

NOTE- The rest of this document will be focusing on the localization framework provided for back-end 
applications. Ul localization will be deferred to a later time when the configuration workspace concept 
has developed to a more mature stage. The localization toolkit will also be assembled when all tools 
and procedures are made available. 

1 .2 Definitions 

1.2.1 Globalization 

Globalization is the process of designing and developing a software product that functions in multiple 
cultures/locales. This process Involves: 

• Identifying the culture/locale that may be supported 

• Designing features which support those cultures/locales 

• Writing code that functions equally well in any of the supported cultures/locales 

In other words, globalization adds support for input, display, and output of a defined set of language 
scripts that relate to specific geographic areas. The most efficient way to globalize these functions is 
to use the concept of cultures/locales. 

1 .2.2 Culture/Locale 

A culture/locale is a set of mies and a set of data that are specific to a given language and geographic 
area. These rules and data Include information on: 

• Character classification 

• Date and time formatting 

• Numeric, currency, weight, and measure conventions 

• Sorting rules 

1 .2.3 Neutral Culture 

A neutral culture is associated with a language but not a region. For example. English ("en") is a 
neutral culture. 

1 .2.4 Specific Culture 

A specific culture is associated with a language and a region. For example, E nglish U nited States 
ren-US") is a specific culture. 

1 .2.5 Localizability 

Localizability is the ability of a globalized application and/or content (including text and non-text 
elements) to be adapted for any local market (locale). 

1 .2.6 Localization 

Localization is the process of adapting a globalized application and/or content, which you have 
already processed for localizability, to meet the language, cultural and political expectations and/or 
requirements of a specific local market (locale). 
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The localization process refers to translating the application user Interface (Ul) or adapting graphics 
for a specific culture/locale. The localization process can also include translating any help content 
associated with the application. 

1 .2.7 Resources 

Resources are anything that the application uses to operate that is not considered executable code. 
Examples of resources include icons, graphic files, strings and objects. 

1 .2.8 Satellite Assemblies 

Satellite assemblies are .NET assemblies that contain resources (strings, graphics, objects, etc) . 
These are typically associated with a main assembly that contains the code that uses the resources 
available in the satellite assemblies. 

1.3 References 

The localization model for the .NET Framework is discussed more thoroughly in MSON. 

2 Objectives 

There are two basic objectives for this prototype: 

• Provide a framework for developers to enable localization and globalize the application with 
minimal impact on coding effort and time. 

• Provide a tool for localizing default resources contained in an assembly. 

3 Globalizing the Application 

The Idea Is to enable localization support with minimum effort from the developers. Since the 
localization routines are pretty much standard, a framework could be developed to help developers 
with globalizing their application. This framework leverages on existing work done for the RoadRunner 
project. The existing localization classes were re-structured to provide a more streamlined code. The 
framework cun-ently handles two major Items, string messages and exception messages. 

3.1 Localizing String Messages 

The .NET Framework contains a ResourceManager class that provides convenient access to 
culture-specific resources at runtime. The ResourceManager class is encapsulated In a 
ResourceStrings class to provide specific methods in accessing localized resources in Starburn. 
The ResourceStrings class is realized in the Deltav. Globalization namespace and provides 
the following: 

An overloaded Getstring method to enable a more efficient and simplified access to localized 
strings. 

A list of resource managers for each resource file. This list is maintained and automatically loaded 
when a resource is requested. This frees the developer from instantiating resource managers In their 
codes. 

The ResourceStrings class in turn is inherited by corresponding resource classes. This means that 
each resource file will have a corresponding .NET class that will be added to the a pplicatlon. For 
example, a resource file clientModelSchema . resx will have a corresponding class called 
ciientModeischema.es- This provides a means of treating each resource identifier as an object 
with a public interface for retrieval of the localized string itself. Some additional benefits of the 
resource class are as follows: 

• Incorrect number of arguments when formatting resource strings is caught at compile time. 

• IntelliSense supplies the retrieval method name and reminds you of any parameters for 
formatted strings. 
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For example, given a resource file called clientModelSchema . resx 





R«$D«rceStf«c» « ! CS«fttMod«i5<h«M.« COentModdSeliema.i«» | 

Data TaWes: Data: 


TestConsoteApp 
1 :t>- ^ R«ferenc«i 








name lvalue | comment |t«>e imimelype j 




MiSSlNG.QUERy Queiv nw found. (nuU) (null) (null) 
R01I.M0T.I50UND TVpo '(oyiJoes not contain pfoporty'd)*. (null) (null) (nuP) 


m 







Figure 3.1.1. Sample string resource file 



A corresponding class (ClientModelSchema . cs) would contain the following: 

using System; 

using System. Reflection; 

using DeltaV. DataAcces 3. Utility; 

namespace TestConsoleApp 
{ 

/ / / < s urrjr.in s y > 

/// Provides access to an assembly's string resources. 

[StringResource( "TestConsoleApp. ClientModelSchema", typeof (ClientModelSchema) )) 

public class ClientModelSchema : ResourceStrings 

( 

static private string _assemblyName; 
static ClientModelSchema ( ) 

* _asseinblyName = typeof (ClientModelSchema) .AssemblyQualifiedName ; 
} 

iregion Localized Resources 

internal static string MISSING_QOERY () 

* return ResourceStrings .Gets t ring ( _assemblyName, "MISSING^OOERV ); 
> 

internal static string ROLE_N0T_F0UND ( object argO, object argl ) 

^ return ResourceStrings .GetString ( _assemblyName, "ROLE_NOT_FOUMD", argO, argl ); 
) 

#endregion 

) 

Figure 3.1.2. Sample resource class 

The Class uses a custom attribute called stringResource that will provide resource file Information 
to the ResourceStrings class. This enables the ResourceStrings class to determine which 
ResourceManager to use In accessing resource files. Each resource in the resource file is accessed 
thru a method. The string formatting contained in the resource file will be specified as method 
parameters. In the given example. 

ROLE_NOT_F0UND = "Type MO)' does not contain property MD'." 

The string formatting specified ({0) and (1>) are converted into parameters (object argO, 
object argl) in the method. This effectively enables the Intellisense support in Visual Studio. 
Figure 3.1.3 shows a snapshot of the Visual Studio editor that demonstrates the listing of resources 
available from a given class. 
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class TeSwApp 

i 

/// ourrj!iAry> 

/// The xt^ais eacry poinc for the appllcacicn. 

/// </suiwT»ry> 

CSTAThreadi 

sca'Ci.c vci^d Main <dT;r£r:^{ ■ arga) 

// 3e^ cJie locaice to G«raaa 3wiczerlandL 

Tl-sreaa.Curren^Thread.CurrensiCuiture » Cuiturelnfo.CreaceSpeelf icCuisure ("da-CH") ; 

CensoJLe.HrlceLine ( "?;saource2 « ** 4 Clleri^odel3c?^ena.|^ 

^ ^> iMISSD^G_Q iJER Y 1 

> a» ROtE_HOT,FOUHD 



Figure 3.1.3. InCelllsenee provides a list of resources available 



Figure 3.1.4 on the other hand shows how the parameter list shows up in inteliisense. This helps the 
developer in providing parameters to localized resource strings that contains string formatting 
characters. 



Cosaele.WriteliiaeJ "SL-rscurcei - ^ Cller.cHcdelSc^esLa.HI55I»G_QU3Ry I) ); 

Console. Wricetir.e( "S*«curce2 - " * CllentMcdel3chgaia . aOL£_«0?_rOU?rD c 

JL* [string aientMDdeiSd»eina.ROLE_HOT,FOUHD (oblect argO, object nrgi j 

Figure 3.1.4. Inteliisense provides a parameter list 



Figures 3.1.3 and 3.1.4 also shows how easy it is to access localized strings from within the code. 

A potential drawback to this approach Is the fact that for each resource string, a corresponding 
method needs to be written. This could potentially lead to a lot of methods and hand coding the 
resource classes would be very tedious indeed. Not to mention that the string formatting will have to 
be checked accurately to ensure that the method reflects the correct number of parameters. This 
issue will be discussed in more details in section 3.3. 



3.2 Localizing Exception Messages 

A natural extension to the localization of string messages is the localization of exception messages. 
The general idea with localizing exception messages is to encapsulate the localization of string 
messages and then add methods by which the actual exceptions can be raised. 

Consider the exception resource file below: 



(o^ SotJtton 'utGcV (2 pRo«ccs) 
B' @ TestOon«(rfcApp 

A90.<O 



Data Tabifl! Data: 



BSSS 


name 


1 value 


A 1 comment |typ« 


1 mimetype | 




LC5_INVAUOOCML 


Eiror paicf ng XMl. Tlio val 


ue Wisnotvabd. (nuO) (mitl) 
(null) (nufi) 


(mid) 


♦ 


LCS_MISSlHG_rNOjnC 


MssmgsndtaginXML. 


(mid) 








£15 



Figure 3.2.1. Sample Exception Resource File 



Notice that this is just another .NET resource file. We distinguish an exception resource thru the name 
. Exception resources always end with the word "Exception" like in the example above. A 
corresponding class to this exception resource file would look like the following: 
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using System; 

using Sysccjo.Ro flections 

using Systoffl. Runtime. SttziallzBtion; 

using Del taV. DatsAccess .Utility; 

namespace TestConsoleApp 
I 

/•/ ':«nsiisajirv«' 

•// Provides OCCC3? to an 093ciably*o :»t:ring £6si:(uru>:^o . 
/ / /' / auwn-> f y V 

IStrlngResouccot "Tcs tCcnsolcApp. QtSExc-jpclcn", typcoC (CHSExceptionResource) M 

intaxnal class CMSCxeeptionltasourea : RasourcoSt rings 

C 

static private atring _aase»blyHame> 

static CMSSKceptionResoucce () 
( 

^ _a9s«mblyNaina • typeof (CMSExceptionResource) .AssemblyQualificdName ; 
•region Localised Resources 

internal static string IiCS_INVAL2D_XNL( object argO ) 

^ return ResourceSt rings. GetString( .assemblyName. -LCS_IMVALID^J»1L". argO >; 
internal static string LC9_MX3SXKG_BHD_TAG(> 

^ return ResourceStrings.GetStrlngt _as8eiQblyNaiiie. ••LCS_mis31«G_END_TA'3" ); 
fendrogioa 

I 

/// A aptscial uoscMjrctt ciaas for handling the raising and displaying of eNceptio.t Bassagea. 

•* •• / ?<rrar^a z V* 

(Serialirable] 

public class CHS&xception : Conf igCxception 

public CMS£xception< string axceptionMessage J : base < except lonHes sage ) 

public CMS£xception< atring exceptionMessaga. Exception exception ) : base ( exceptlonMeasage, exception ) (I 
public CHSExcepClon< SeriallzationinCo info, StreamingContext context ) : base ( info, context ) () 

Internal static void Raiae_LCS_lKVALID_XML (Exception ex. object argO ) 

Raiaef typeo£ (CMSException) . CHSexceptionResource.LCS_IHVALTD_XHL(argO} , ax ) ; 
internal static void Raisa_X^S_^ZNVALID_XML ( object argO ) 

Raise ( typeof CCMSBKcept ion ) , CMSExceptionRoaource . LCS_IMVAL1D_xml (axgO) ) t 

incernal static void Raise_LCS_HISSIN6_END_TAG (exception ex) 

Raise ( typeof (CHSBxcept ion) « CMSExceptionResource. LCS_MtSSING_ENO_TAC () , ex }j 
internal static void Raise_LCS_HISSXNG_END_TAC< ) 

Raise ( typeof (CHS exception) , CHSExceptionReaource . LCS J4IS9XNO_END_TAG () ) ; 

Figure 3.2.2. San^le Exception Class 

The first thing you will notice Is that there are now two classes. The first class Is actually the same as 
the class created when localizing string messages. The noticeable difference is that this time, this 
class is now internal as opposed to being public. Other than that, it is just a localized string 
message class. The second class is what makes this more Interesting. First off. this class inherits a 
class called Conf igException. This class is also available from the Del tav. Globalization 
namespace and provides the following: 

• An overloaded Raise method for raising an application exception. 

• An overloaded ToString method to enable chaining of exception messages. That is. 
messages from inner exception are also retrieved and all the messages are then enumerated 
as a list. 

Next, each exception resource gets associated with a corresponding raise method. Again, the 
parameters are made available In Intellisense and are checked at compile time. 
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J 

e«toh (excep«i«s ex| 

i 

rt» rRih»_LCS_D(VAlP_?(m 



I 

caccii (Exsepcicr. e«) 



■ Ms Irf 2a void CMSExcttptton^Raise_CCsIlHv>AUDj(WL (SYStcni.Cwieption cac object ergO]| 



Figure 3.2.3. intellisense shows exceptions that can be raised and the parameter list 



Note that when an exception is raised for each exception resource, the type of the exception class is 
passed to Conf igException. This actually helps during debugging of the application. When a 
localized e xception is raised, a developer c an s ee in t he d ebug w indow the type of the exception 
raised. In this particular example, the type of the exception would be displayed as CMSException 
when debugging the application. Refer to the figure below for an example. 




T«stConsoleApp 
^ Rif«7«nc9» 

Si piS£xe«prion j«a 

UtfitV 
^ R«fe:«ncss 

^ R«tourc«SaTigs.o 
Sj S:m9R«sourc«Mtri)ut«-c» 



25 
79 



i 



M-z^zzc veld f«&10 




Syi£«.'Tt.Ob>J«ci <T«r:Contol«AM>.04SCxcQ9aor.> 

.COMPb4E««otionCci -532435699 
_«xc«ot»f:H«th8ti <unde/n8d vihj«> 
_exc«9tlonH«chod5tri nul 
^•bURL nul 
^R«<U« -2146232832 



SyR<m.Re!lectl9n>ie?hotf8as« 



Figure 3.2.4. Watch window shows type of exception 



As you can see, the type CMSException is shown on the right side of the watch window in debug 
mode. 

Using the exception classes In the code i s also relatively simple. A sample code below simulates 
catching an exception from an application. 
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stacic void Hain (string!] arQa) 
I 

// s«t thd locolca CO c«man Swicserlana 

Thread. Cucr«ntThc«ad*CurcantCaXtufa - CultUBalnfe.CcoataSpeeifieCultureC'Ja-CH") t 

try 
I 

Fall O I 

) 

catch (Bxcoption ex) 
I 

Con9olo.WxitoLino(**£xc4p<-.-icn m^ss^go - - ♦ ax .ToSCring () ) ; 
Consola . RaadLina O .* 

> 

stacic void FailO 
I 

tey 
I 

Fail2(); 

> 

catch (Excoptien ax) 
I 

CMSCxception.Raiaa LCS INVALID XHLCeii. "X'iS")! 
I ~ 

I 

static void rsll2 0 
I ■ 

^ thcow naw AppllcatlonSxcoptlon ("Cannot piocASS cb*£ atrlng.*); 

Figure 3.2.5. Sample application that uses the localized exception class 



In this sample, the Fail2 method throws an application exception which Is caught by the Fail 
method. The Fail method then consumes this exception and raises its own exception 
(CMSException) passing in a parameter of "XYZ". Finally, the application catches the exception and 
calls the overridden ToString method of the exception to display all exception messages including 
those from the Inner exceptions or the exceptions consumed by CMSException. The example output 
below shows how the ToString method concatenates all the exception messages into one string 
message. 



m C:\Starbum\l:ocaIi2ation\ytjiity\Tesi^^^^ 




txception nessaye = 1. Cannot pi^ocesc tljc sti*ifit/. 
2. Error parsing XML. The value 'XVZ' is not w<^lid. 




1 
-1 


lU-.. 1 




Figure 3.2.6. Sample output showing list of exception messages 



You will also notice in the code shown In Figure 3.2.2 that the CMSException class is marked with 
the Seriaiizable attribute. This supports the serialization of the exception classes. This means 
that exceptions thrown from a different process space can be serialized across the wire and be 
effectively reconstructed on the receiving end. Thus, exception messages can be passed and 
displayed across different process spaces. 

3.3 DVResourceGenerator 

There is still the problem of hand coding the corresponding string and exception resource classes. It 
turns out that a significant amount of time will be needed by the developer to just create these classes 
from the resource files. Furthermore, keeping the resource files and the resource classes 
synchronized is also a time consuming task. 
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In order to alleviate this problem, a custom tool will be provided to the developers. This custom tool 
called DVResourceGenerator will be attached to the resource files and it should generate the 
corresponding classes. Another advantage of this tool is that every time a resource file is edited and 
saved, the resource classes are also regenerated. Hence, all the developer need to do now is just 
create a resource file C.resx) and associate It with the custom tool. Any updates (add. edit or delete) 
done to the resource file should automatically reflect back to the con-esponding resource class. 

To enable this custom tool, you first need to register It so that Visual Studio will know where to find It. 
This can be accomplished by opening up a command prompt and Issuing a regasm command to the 
custom tool. This is shown in the figure below: 



i*jii;iiUM-wjj.iViiJ»iJak 



ironnui.l for iiy Hici-usoft Ui::u<»l 3t*uliu -Nl-T i^mO imils. ^ 

cools f»'on the conn<rfid iinc, t-tin vc w<m-s'J2 - brtC foi- that wcrsioi».> 

nLoco I i2<»t ion>i-c'jA = o /co«<ehrtse DURe5oiii-ceGt;nei'£kCo»«.dl 1 

H> .Nl-r Frontji/DiK noscr.hly Re9 isvral io.i Utilitv l.t.1322.SV3 

C) Microsoft CinnJo»*At ion 1VVH-VH1M2- nil i-iyht^ r«;: o i-wod . 

liny: Ki?£i istcM' Infi rtii ui>-^-iifnucl «S3cnblv» with ✓codeh.^so can cau:;i: yom- 
interfei*e tjith other applicixt ions thrtt nfty he instil lied on the crtinc c 
»c /'codchrtsc m/itch iy intended lu ho iiuud unly with signed asscnbllos 
lue vf>*»»* Asnfinhlo r» ntrnny n.inn ."»nd iMi-roy ist.p.i* it. 
ttci'cd succcssFti 1 ly 



: xSf ;vrhnrn\I.oc€i 1 i:tAt ion > 




Figure 3.3.1. Registering che custom tool 



This publishes the tool in the windows registry and allows Visual Studio to use this custom tool. 



Registry Editor^^ , ; 



1 ^ j i I B-Sl Gtneretors 

i ^ , j i (i«4B10B9'e2O0'UOO-8C41'00A0C91E: 


r^sme i 


Type . , 


i Data 




REG.SZ 


St&rburn Resaurc« Code Oft«rafcof 


^ jS) {20rM82«B C6f=A-45db-90F4-C7l7S708; 






{040304 1 0-CE22-44S0-BA62-E7C968FA3«34> 


! 1 J ! I 1 ffi <»43077S0-4C4$*4d2d-B523*A3B42F5a 


^CftnerMtsOeslgnTimeSource 


RE0.0^VORD 


0x00000001 (1) 


. 1 > i : J • ® (SI (E6FOF8B0^3Dl-llO4-8S7«-0002A51«l 








j i ! ; , ^ ^d) (PAE04ECl-30tF*lld>BF4B-OOC04F79l 








1 ! ? 5 i ! « fei .rpt 








i ! 1 i I ; : CH) Oy5tBtD<ds»ons.v^Shell.CodeG<rUti 
















{ ) [ ' j ) MSOAtaSctCeneretor 








i I ( j 1 MSDIscoCodeC«nerstor 








j : i t 1 ; ^- ^ SBColI«ctlcnCen«rBtor 








i : 1 ; 1 KandltlnComtnoCell 









Figure 3.3.2. Publishing the custom tool in the registry 



Figure 3.3.3 shows a sample resource file called clientModel Schema. resx. The property window 
for this resource file shows where a Custom Tool can be specified. In this particular case, what we 
want to do is to create the corresponding resource class called clientModelSchema . cs which will 
contain the methods needed to access the localized resource strings. For the developer, after creating 
the resource file and adding alt the resources, it is simply a matter of typing the custom tool name in 
the property w indow. O nee the custom tool DVResourceGenerator has b een s peclfied ( refer to 
Figure 3.3.4), the corresponding resource class should be generated. By default, Visual Studio does 
not display the generated class. In order to see the class that has been generated and added to the 
application, click on the Show All icon in the Solution Explorer. A $ symbol will be displayed next to 
the resource file. Click on the symbol to expand the view and the generated class should be 
displayed. Double-clicking on the class will open up the generated class in the Visual Studio 
workspace (refer to Figure 3.3.4). 
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13 soiudon UtCiC/ (2 ontfects) 

f@) TestConsoleApp 
^ ^ References 

; O bin 
! a>- L3 Ob) 
I ! , g?j App.fco 

I CtientModQSchema.res( 
I CMSException^sx 
^ TestAop.cs 



I a(entHodeiSchemd.resit R!e Properties 



Buad Action Embedded Resource 

jQioom^mim 

Custom Tool Namespac 



;!!•> nie Name 



C&erra-lode Sche ma^resx 

C:\Sr3fbuiT.\toc3^??.r:.^5nVJrr5 



r>:4in dam 



lvalue 



LCS.INVAUD.XML 6rrof pafsing XML. The value '(0)' Is not vafid. 

LCS_MIS5ING_£ND_TAG MissIng end tag In XML. 



. o >s <j *■ o r, i » 
. • C i . ^ . • 



Figure 3.3.3. Sample resource file 



You will notice from the generated class a comment that states that this class has been auto- 
generated and that directly editing the class Is not advisable because all changes will be overwritten 
when the class is regenerated. 



1 1*1 T'j:v:&.'«oJ<AppJ:'iCTWod«iE«fc<n»» 



3- @1 TcscconsotBApp 

J S- LJ bn 

\ <- jgj A9p.lC9 



aientModelsdiem».resx Rl« Piopeittts 



"3 



;Oon ^ ^ lErrt«dtJe<J Rcsoarc« 



; Ouslom Tool Namotoar 

Naim |citr.a>iec«Sd;.«naj«« 



// T^ZA esin WA9 ce:^era^«d by ^^.e 5s«r&urs Asacsrce 9«c.«:«^c: %3al. 
// 

// Do =uk« c»4;&l9»vtcrK5 dii;:ee7.1v fxen ^his 2ile as aay sr.«ccea ts«ke 

// edit ch« ccrr«9p!W3S.r»c r«30*iie« ftad »*•-•# «>.«.7.««» cr:.g<«» r*-a«eftXA«l.9&. 

// 

// T&.a.« a«neaie» elikA«ft« fi«riftti ffr» r-e ssr.ceata c« ch« r««s-ire« «il«t 



1 iE3 u«ir.9 5y«c«su 



/ / <«*JsriaLft ; v> 
/ / f* C/ 9U£X» z -j> 

93fc2Lc class Ciier.LK;£el3e:r.«s:A : R«sa!ixee5%rir.ff9 
i 

cJiv«?« otrico _««««rfcls<j«sA; 



id 



Figure 3.3.4. The generated resource class 
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3.4 Summary 



The framework provided by the globalization classes (ResourceStrings, String Resource Attribute, and 
ConfigExceptlon) provides the foundation by which an application in Starburn can be globalized. And 
as an additional help for developers, the use of this framework is made more intuitive and easy by the 
use of the custom tool DVResourceGenerator. This custom tool hides the complexity of managing 
resource classes and resources in general All that a developer has to be concerned with is identifying 
the resources to be localized and where in their application code these localized resources need to be 
accessed. 

The framework combined with the custom tool addresses the first objective of this prototype. 
Localization can now be incorporated in Starburn applications with minimal impact and effort on the 
part of the developer. 

4 Localization Support 

Once the application has been globalized and is deemed ready for localization, a resource toolkit 
needs to be In place to help with the actual localization of the application. The first step towards this 
toolkit Is coming up with a resource tool that can analyze the .NET assemblies and create the 
corresponding satellite assemblies from the translated resources. 

The resource tool should be able to do the following: 

1 Read an application assembly and extract the default locatizable resources. 

2 Provide a translation editor for translating the default resources. 

3 Read the translated resources and create the localized satellite assembly. 

4.1 Extracting the Default Resources 

The activity diagram below shows how the prototype extracts the resources from the given 
assemblies: 




G«t Flm AtMinbty 
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4.2 Translating the Resources 



An editor similar to the mock-up screen below will be used to translate the default resources to a 
specific culture. 



I^Starburn Resource Editor StSiS 



j Q l^i ! X Q:^ X m ^ ,t^f 



When all the resources h ave b een translated, clicking on the save icon should bring up a window 
similar to the one below to indicate which culture the translation will be saved to. The correct culture 
name will be appended to the filename of the translated resource. 



Select Cutture . 



Mrkom (South fiiiiea} 

ATbonkn CASwrto) ^ 

Aneb'c {Btthrain} 
A/Bbfc (Eoyot) 

A-Bbte (Labanon) 
A'«bfc<La»ya) 
A-ebic (Morocco) 
Ar»b»c JOmen) 

A'Bbic {Sdui A'sfasa) 
A'abc (Syrid) 
Anftte: (Tunisia} 

fw> i 

Ok 



Caneei 



For example, when the default resource clientModelSchema.resx gets translated into the neutral 
culture French, It will be saved as ClientModelSchema.fr.resx. If a specific culture is chosen 
like French-Canada, the resource file will be saved as Client Model Schema . f r-CA. resx. 
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4.3 Creating the Localized Sateliite Assemblies 

The activity diagram below shows how the prototype creates the satellite assemblies: 



^tiit At— ml>ll— wttft Tmnrittfd Rojourw^ 

^ ^ ^ 

_ 



r Get First Tronslsiod Roaoureo 



-^ ^Coiwett the Reiourc*^ 
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tattAtMinbV? 



^G*t Ham A»8mtoly^ < ^ ^ *® 



Stop Sloia 



The satellite assemblies created will automatically be placed in the corresponding culture folder under 
the main assemblies folder. This is in line with the resource fallback scheme implemented in the .NET 
Framework. 
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5 Appendix - Globalization Classes 



5.1 ResourceStrings Class 

using System; 
using System. Resources ; 
using System. Reflectlon; 
using System. Globalization; 
using System. Threading; 
using system. col lections; 

namespace Del taV.DataAccess. Utility 
{ 

public class ResourceStrings 

{ 

#region Public GetString Method (Overloaded) 
/ / / <s uitiniA r y 

/// Loads an unformatted string 

/ / / <. / 3 tunma t y > 

/// <parajii name" "re.soiiriTe.Irt">Identifier of string resource*' /par Am-** 
/// <ceturn55Vstring</r«5fcur ns> 

public static string GetString ( string typeKame, string resourceld } 
{ 

string resourceValue - null; 

ResourceManager rm » GetResourceManager ( typeName } ; 

if ( rm !» null } 
{ 

resourceValue a rm. GetString ( resourceld ); 

} 

if ( resourceValue == null ) 

{ 

resourceValue » resourceld; 

} 

return resourceValue ; 

) 

/ / / 'Csujiim-j ry :» 

/// Loads a formatted string 
/ / / / siinttfia L*y> 

/// <parain r(aintr="resovircftId">Identifier of string re source'*. /pa raiti> 

//■/ <|>;ii;aia nam©— "objects":* Array of objects to be passed to string. Format «: /pa lo!d> 

/ / / ^. r t iJ r n s s t r X ng / 1 e t ur u s > 

public static string GetString ( string typeName« string resourceld, params object (3 
objects ) 

{ 

string resourceValue » null; 

ResourceManager rm > GetResourceManager ( typeName ); 

if ( rm != null ) 
{ 

resourceValue » rm. GetString ( resourceld }; 

) 

if ( resourceValue !«• null ) 

( 

return s t ring. Format ( resourceValue, objects ); 

) 

else 
{ 

return resourceld; 

} 

} 

tfendregion 

#region Resource Managers code 

private static Hashtable ^ResourceManagers = null ; 

public static ResourceManager RegisterResourceDll < string typeName « 
string baseName, Assembly assembly ) 
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{ 

ResourceHanager rm o new ResourceManager ( baseName, assembly ) ; 
ReaourceManagers.Add ( typeName« rm ) ; 
return rm ; 

} 

private static Hashtable ReaourceManagers 

get 
{ 

lock ( typeof ( Resourcestrlngs ) ) 
{ 

if ( ^ReaourceManagers «*■> null ) 

( 

ReaourceManagers = new Hashcable ( ) ; 

) " 

) 

return ReaourceManagers ; 

) 

) 

private static ResourceManager GetResourceManager ( string typeName ) 
( 

ResourceManager rm « ReaourceManagera (typeName] as ResourceManager ; 

if ( rm null ) 

{ 

object [] strlngResources - Type.GetType ( typeName } .GetCustomAt tributes 

typeof ( StringResourceAttribute ) , true ) ; 
if ( StrlngResources la null } 
{ 

StringResourceAttribute string Resource • strlngResources [0] as 
StringResourceAttribute ; 

rm = RegiaterResourceDll ( 
typeName , 

stringReaource .baseResource, 
a tringResource .assembly ) ; 

) 

) 

return rm : 

) 

#endregion 

} 

} 



5.2 StringResourceAttribute Class 

using Syst emb- 
using System. Reflections- 
namespace Del taV.OataAccess. Utility 
{ 

(Attributeusage (AC trlbuteTargete .Class ) ] 

public class StringResourceAttribute : Attribute 

{ 

public readonly string baseResource ; 
public readonly Aasembly assembly ; 

public StringResourceAttribute ( string baseResourceName« Type t ) 

this .baseResource » baseResourceName ; 
this .assembly « t .Assembly ; 

} 

} 

} 

5.3 ConfigException Class 

using Syet emb- 
using System. Col lections; 
using System. Text; 

using System. Runtime .Serialization ; 

namespace Del taV.DataAccesa. Utility 
{ 

tSerializable] 

public class ConfigException : ApplicationException 
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#region Constructors 

public Conf IgExceptlon () {) 

public ConfigExceptlon ( string except ionfJessage ) : base ( except lonMessage ) {) 
public ConCigBxception ( string except IcnMeesage. Exception exception } 

base (except lonMessage, exception ) {} 
public ConCigBxception ( SerializationXnfo info. St ream! ngCon text context ) : 

base ( info, context ) {) 
ftendregion 

#region Overloaded method for raising the exception 

public static void Raise ( Type except lonType, string except lonMessage ) 

throw Activator. Create Instance ( 
except ionType , 

new Object (] { except lonMessage } ) as ConfigExceptlon ; 



public static void Raise ( Type except ionType, string except lonMessage, Exception 
exception ) 
{ 

throw Activator .Createinstance ( 
except ionType , 

new Object U { except lonMessage, exception } ) as ConfigExceptlon 
iendreglon 

# region Overridden Methods of AppllcationExtenslon 

/ / / < s ujxiina r y > 

/// This creates a list of exception messages composed of the original exceptions 

/// as well as the inner exceptions. 

/ . ' / < / s 11 mma r y > 

/ / / <re t. u r. ria > < / re t u rna > 

public override string ToStringO 

ArrayLlst messageList - new ArrayLietO ; 

Exception ex « this ; 
while ( ex i» null ) 
{ 

messageList . Insert ( 0, ex. Message ) ; 
ex e ex. innerException ; 

} 

int Idx « 1 ; 

StringBuilder sb - new StringBuilder ( ) ; 
foreach ( string s in messageList } 

sb.AppendFormat ( -{0>. (l}\n", idx++, s ) ; 



^ return sb.ToStrlng () ; 
#endreglon 
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Diagram Control 
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1 Introduction 
1 .1 Overview 

There are several graphical editors in current DeltaV system to help customers create and debug 
control strategies in an Intuitive way. The graphical editors include Control Studio Diagram Control 
(edit and online mode), Recipe Studio Diagram Control, and Operator Interface graphic editor. Control 
Studio Diagram Control and Recipe Studio Diagram Control share the same code set. but draw 
different shapes based on the context. Operator Interface graphic editor uses completely different 
drawing tool. 
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1.2 Definitions 

1.3 References 

1.4 Deliverables 



2 Objectives 

The objective for this prototype is to build a generic diagram control that can be used by various 
graphic editors includes Control Studio, Recipe Studio, DeltaV Operator Interface. The diagram 
controls should also be able to be embedded in run time applications in read-only mode. 
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In order for the diagram control to be used In many ways. It Is critical that the diagram control is 
independent of any specific context information. It is up to the containing application (views or applets) 
to provide the correct data for the diagram control to function. 



Here is a list of objectives: 

1 . The diagram control is contained by a view. 

2. The view is contained by a package. 

3. The diagram control does not talk to Client Model directly, it will communicate with the Client 
Model via its containing view. 

4. The diagram control gets pre-defined dataset from its containing view. 

5. The diagram control should be able to change the drawing without having to refresh the entire 
diagram. 

6. When user Interacts with the diagram control, the diagram control will perform the operations 
and fire events to the containing view. 

7. The diagram control stores the object related state information (for instance, font setting, color 
setting, etc) to the configuration database via its containing view. 

8. The diagram control will store its global state information (size, maximized or minimized) in 
Registry. 

g. The diagram control makes no distinction of a FB module, a SFC, or a display. The 
constraints (for example, which connectors are allowed to be connected) are captured by the 
dataset passed to the diagram control by the containing view. 

10. The diagram control gets its context menu from the containing view. When user invokes a 
context menu, the diagram control will perform some operation and then fire the event back to 
the containing view. The context menu may include Save, Copy and Paste, Delete, Undo, Re- 
do etc. 

11. The containing view will act as a data store for the diagram control. The diagram control will 
not cache any interim data. 

12. The diagram control will publish a set of interfaces for the containing view to tie In. 
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User Interface 
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Figure 1 - Conflguration Workspace 
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4 Object Model 

The object model illustrates how the diagram control is related to the configuration workspace and client 
model. 
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Figure 2 - Architecture of Workspace 
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4.1 .1 User launches the function block diagram view 

The diagram view is a standalone application. User can launch It from the "Run" command. 

System Response: The application will launch with a function block view that contains a diagram control. 



Function. BloekDi&g^^m View 



Open MODI 



Save MOD 1 



AdclBlock3 



Block3 



Add PaxumI 



On- Line 
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.1 .2 User opens an existing module in diagram control for editing 

4.1.2.1 Preconditions 

a) Diagram Control is empty. 



4.1.2.2 User Actions/System Response 







User selects trie "Open MODV button from 
the container. 


The diagram view is loaded with all the objects 
positioned with connection lines based upon the 
last time saved. 
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Figure 3 - Data Collaboration Diagram for Open an Existing Module 
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. 1 .3 User adds a connection between two connectors 

4.1.3.1 Preconditions 

a) Diagram view is launched. MOD1 is loaded. 

b) At least one unused input and an output connection may exist on the diagram. 



4.1.3.2 User Actions/System Response 



Use^ Actions 


System. Response 


User positions mouse cursor on an input knob 
or an available output knob. 


The connection cursor is displayed. 


User depresses left mouse button. 




User drags cursor to knob of opposing type. 


A transitory line is displayed and updated as the 
user drags the mouse. The target hit cursor is 
displayed when positioned over a valid connection 
location. 


User releases left mouse button. 


If the user releases on a valid opposing connection 
an appropriate line is displayed. If the user does 
not release on a valid opposing connection the 
transitory line disappears. 




Figure 4 - Data Collaboration Diagram for Add a New Connection 
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4.1 .4 User adds a new function block to the module 
4.1.4.1 Preconditions 

a) Diagram view is launched. MODI is loaded. 



4.1.4.2 User Actions/System Response 



User Actions 


System Response 


User clicks on "Add Blocks'* button 


Blocks appears in the diagram control in a pre- 
specified position. 





Figure 5 • Data Collaboration Diagram for Add a New Function Blocic 
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.1.5 User adds a new parameter to a function block 



4.1 .5.1 Preconditions 

a) Diagram view is launched and MOD1 is loaded. 



4.1.5.2 User Actions/System Response 







User clicks on "Add Parami" button 


Parami appears in the diagram control in a pre- 
specified position. 
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Figure 6 - Data Collaboration Diagram for Add a New Parameter 
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4.1 .6 User deletes a function block 



4.1.6.1 Preconditions 

a) Diagram view is launched and MOD is loaded. 

4.1.6.2 User Actions/System Response 







User selects a function block "Blockl". 


Blockl is selected 


User clicks on the "Delete" button 


Blockl is deleted if the deletion is allowed, 
otherwise, an error message will be displayed 



4. 1 .7 User saves the module 



4.1.7.1 Preconditions 

a) Diagram view is launched and MOD is loaded. 

4.1.7.2 User Actions/System Response 







User clicks on "Save MODI" button. 


MOD1 is saved back to the Client Model and the 
objectivity database. 



User «aveModule() 
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Figure 7 - Data Collaboration Diagram for Save a Module 
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4.1 .8 User right clicks on the diagram control to view the properties of MOD1 



4.1.8.1 Preconditions 

a) Diagram view is launched and MOD is loaded. 

4.1.8.2 User Actions/System Response 







User right cliclcs on an empty space of the 
diagram view. 


A context^menu pops up with one option 
"Properties" 


User selects on "Properties" 


A dialog pops up display the properties of MOD1 



.J 
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4. 1 ,9 User opens an existing module in diagram control for debugging 



4.1.9.1 Preconditions 

a) Diagram view Is launched and MOD1 Is loaded. 

4.1.9.2 User Actions/System Response 



User Actions 


System Response 


User clicks on "On-Line" button. 


Diagram view will ciiange the data source from 
Client Model to read^ run time data. 
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Figure 8 - Data Collaboration Diagram for Debug 

4.1.10 User embeds the diagram control in a runtime environment 

TBD. 

This will require the containing view be self-sufficient? The containing view should support a mode that is 
not dependant on the workspace frame work. Or should we Just embed an instance of the workspace with 
a very restrictive mode (open one module read only)? 



* Depending on the progress of this project, the run time data may be a set of pre-specified value. 
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5 Interface design for Diagram Control 



5.1 IDiagramControi 

5.1 .1 iDiagramControl.createDiagram 

Method 

createDiagram ( 

CDiagraminf o diagramlnfo 

) ; 

Description 

This interface method is called by the containing application to pass in a pre-defined dataset 
describing the diagram to draw to the diagram control. This dataset contains the description of the 
diagram in a way that is understood by the diagram control. 



Parameters 







ffii^^iSfsaiiaMi^^^sgg^M 


diagramlnfo 


CDIagramlnfo 


The pre-defined dataset to describe the shapes to draw 
from the diagram control 



Exceptions 









DC_FAIL_TO_CREATE_DIAGRAM 


This exception will be thrown when the diagram 
control falls to create the diagram requested. 



Comments 



This method should be called before any other requests to the diagram control to draw a diagram. 
5.1 .2 IDiagramControl.addFigure 

Method 

addFigure ( 

String strFigureName , 
CFigurelnfo figurelnfo 

) ; 

Description 

This interface method is called by the containing application to pass in a pre-defined dataset 
describing the figure to add to the diagram control. This dataset contains the description of the 
objects in a way that is understood by the diagram control. 



Parameters 









StrFigureName 


String 


The name of the figure being added 


figurelnfo 


CFigurelnfo 


The pre-defined dataset to describe the shapes to draw 
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j from the diagram control 

Exceptions 







DC_FAIL_TO_ADD_FIGURE 


This exception will be thrown when the diagram control fails 
to add the figure requested. 



Comments 

Depending on what shapes are contained in the CFigurelnfo object, the diagram control will create 
corresponding shape objects accordingly. The shape objects will contain Its corresponding data. 



5.1 .3 IDiagrannControl.acidConnection 

Method 

addConnection ( 

CConnect:ionIn£o connect ionlnfo 

) ; 

Description 

This interface method is called by the containing application to pass in a pre-defined dataset of 
connection to add to the diagram control. This dataset contains the description of the objects in a way 
that is understood by the diagram control. 



Parameters 









connectionlnfo 


CConnection Info 


The pre-defined dataset to describe the connection to 
draw from the diagram control 



Exceptions 







DC_FAIL_TO_ADD_CONNECTION 


This exception will be raised when the connectors 
associated to this connection are not created in the 
diagram control. 



Comments 

This method assumes that the associated connectors have been created. If this condition Is not 
satisfied, exception will be raised. 
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5.1 .4 IDiagramControl.deleteFigure 

Method 

deleteFigure ( 

String strFigureName 

) ; 

Description 

This interface method is called by the containing application to asic the diagram control to remove a 
figure based on the figure name passed. 



Parameters 









StrFigureName 


string 


The name of the figure to be deleted 



Exceptions 





^•a>es(giiiffti6B'^:^.^#^%i^%if^ 


DC_FAIL_TO_DELETE_FIGURE 


This exception will be thrown when the diagram control 
fails to delete the figure requested. 



Comments 

This method will remove the figure in the diagram control as well as the connections related to it. 
5. 1 .5 IDiagramControl.deleteConnection 

Method 

deleteConnection ( 

String strStartFigureName , 
String strStartConnectorName , 
String strEndFigureName, 
String strEndConnectorName 

) ; 

Description 

This interface method is called by the containing application to remove an existing connection 
between the specified start and end connector names. 



Parameters 









StrStartFigureName 


String 


The name of the start figure for the connection 


StrStartConnectorName 


String 


The name of the start connector for the connection 


strEndFigureName 


String 


The name of the end figure for the connection 


StrEndConnectorName 


String 


The name of the end connector for the connection 
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Exceptions 







DC_FAIL_TO_DELETE_CONNECTION 


This exception will be raised if the connection can 
not be located or deleted. 



5. 1 .6 IDiagramControl.updateFigure 

Method 

updateFigure ( 

String strFigureName, 
CFigurelnfo figurelnfo 

) ; 

Description 

This interface method Is called by the containing application to ask the diagram control to update and 
draw the corresponding figure based on the CFigurelnfo passed. 



Parameters 









strFigureName 


string 


Name of the figure to update 


ftgurelnfo 


CFigurelnfo 


The pre-defined dataset to describe the shapes to draw 
from the diagram control 



Exceptions 
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DC_FAIL_TO_UPDATE_FIGURE 


This exception will be thrown when the diagram control 
fails to update the figure requested. 



Comments 



This method will update the figure object in the diagram control without having to repaint the entire 
diagram. 



5.1 .7 IDiagramControl.getFigurelnfo 

Method 

CFigurelnfo getFigureInf o ( 
String strFigureName 

) ; 

Description 

This interface method is called by the containing application to retrieve the CFigurelnfo object from 
the diagram control. 
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Parameters 









strFigureName 


String 


Name of the figure whose info is to be retrieved 



Return 













CFigureinfo 


The pre-defined dataset for figure info 



Exceptions 







DC_FAIL_TO_GET_FIGUREINFO 


This exception will be thrown when the diagram control 
teils to retrieve the CFigureinfo object. 



Comments 

This method assumes that the figure requested exists. Otherwise, an exception will thrown. 
5.1 .8 IDIagramControl.draw 

Method 

draw ( ) ; 
Description 

This interface method is called by the containing application to ask the diagram control to draw 
corresponding figure(s) based on the CFigurelnfo(s) passed in previously. 

Exceptions 







DC_FAIL_TO_DRAW 


TTiis application exception will be thrown when the diagram control 
fails to draw. 



Comments 

This method should be called after methods that add objects to the control (i.e. AddFigure()) are 
called. The user can call multiple add object methods before invoking this method. 

5.1 .9 IDIagramControl.createFigurelnfo 

Method 

CFigureinfo createFigureInf o ( ) ; 
Description 

This interface method is called by the containing application to create an empty CFigureinfo object. 
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Return 







CFigurelnfo 


The pre-defined dataset for figure info 



Exceptions 







DC_FAIL_TO_CREATRE_FIGUREINFO 


This exception will be thrown when the diagram 
control fails to create a CFigurelnfo object. 



Comments 

This method will return an empty CFigurelnfo object to the caller. 
5.1 .10 IDiagramControl.createShapelnfo 

Method 

CShapelnfo createShapeinf o (SHAPE_TYPE enShapeType) ; 
Description 



This interface method is called by the containing application to create an empty CShapelnfo object. 
Parameters 









enShapeType 


SHAPE_TYPE 


The type of shape to create 



Return 
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CShapelnfo 


The pre-defined dataset for shape info 



Exceptions 







DC_FAIL_TO_CREATRE_SHAPEINFO 


This exception will be thrown when the diagram 
control fails to create a CShapelnfo object. 



Comments 

This method will return an empty CShapelnfo object to the caller. 
6.1 .11 IDIagramControLcreateConnectorinfo 

Method 

CConnectorInf o createConnectorInf o ( ) ; 
Description 

This interface method is called by the containing application to create an empty CConnectorlnfo 
object. 
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Return 







CConnectorlnfo 


The pre-defined dataset for connector info 



Exceptions 







DC_FAIL_TO_CREATRE_CONNECTORINFO 


This exception will be thrown when the 
diagram control fails to create a 
CConnectorlnfo object. 



Comments 

This method will retum an empty CConnectorlnfo object to the caller. 
5.1.12 IDiagramControl.setState 

Method 

setstate ( 

DiagramState enState 

) ; 

Description 



This interface method Is called by the containing application to set the correct mode. 
Parameters 









enState 


DiagramState 


Different modes of the diagram control. The available modes are: 






EDIT 






DEBUG 






ONLINE 






READONLY 






The default mode is EDIT. 



Exception 







DC_FAIL_TO_SET_STATE 


An exception Indicates that the state is not set con-ectly. 



Comments 



This method will detenmine how diagram control reacts to different user interactions. If DEBUG or 
ONLINE state is selected, the diagram control will become read only. 
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5.1 .13 IDiagramControl.setDiagramControlProperties 

Method 

setDiagramControlProperties ( 

CDiagramControlProperties diagramControl Props 

) ; 

Description 



This interface method is called by the containing application to set the properties of the diagram 
control. 

Parameters 











diagramControl Props 


CDiagramControlProperties 


The properties of the diagram control. { 



Exceptions 











DC_FAIL_TO_SET_PROPERTY 


An exception indicates that the property is not set 
correctly. 
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6 Events 

TBD - The diagram control will propagate all the windows events back to the containing view with the 
same parameter lists if the diagram control catches the events first. 

6.1.1 NewFigure 

Event 

NewFigure (CFigurelnfo f igurelnfo) 
Description 

This event will be fired from the diagram control to the containing view when there is a new figure 
being created. 

Parameters 









figurelnfo 


CFigurelnfo 


Dataset describing the new figure 



6. 1 .2 NewConnection 

Event 

NewConnection (CConnectionInf o connectioninf o) 
Description 

This event will be fired from the diagram control to the containing view when there is a new 
connection being created. 

Parameters 









connectionlnfo 


CConnectionlnfo 


Dataset describing the new connection 



6.1 .3 VerifyConnection 

Event 

VerifyConnection (CConnectionlnfo connectionlnfo) 
Description 

This event will be fired from the diagram control to the containing view when user tries to create a 
new connection. 

Parameters 
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connectionlnfo 


CConnectioninfo 


Dataset describing the new connection to verify 
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6.1.4 DeleteFigure 

Event 

DeleteFigure (String strFigureName) 
Description 

This event will be fired from the diagram control to the containing view when user deletes a figure 
Parameters 











StrFigureName String 


Name of the figure deleted 







6.1 .5 DeleteConnection 

Event 

DeleteConnection (CConnectionlnfo connectioninf o) 
Description 

This event will be fired from the diagram control to the containing view when user deletes a 
connection. 

Parameters 









connectionlnfo 


CConnectionlnfo 


Dataset describing the connection deleted 



6.1.6 GetFigureContextMenu 
Event 

GetFigureContextMenu (CFigureInf o f igureinf o) 
Description 

This event will be fired from the diagram control to the containing view when user selects on a figure 
and right clicks to get the context menu. 

Parameters 



^'Sajfeli^l 






figurelnfo 


CFigurelnfo 


Dataset describing the figure whose context menu was requested 
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6. 1 .7 GetDiagramContextMenu 

Event 

GetDiagramContextMenu (CDiagramlnfo diagraminf o) 
Description 

This event will be fired from the diagram control to the containing view when user right clicks on the 
diagram. 

Parameters 









diagramlnfo 


CDiagramlnfo 


Dataset describing the diagram. 



6.1.8 NewPosition 
Event 

NewPosition (String strNatne, Point newPosition) 
Description 

This event will be fired from the diagram control to the containing view when user moves an object 
and release the left button. 

Parameters 













strName 


string 


Name of the object moved 


newPosition 


Point 


New position of the object 



6.1.9 NewSize 

Event 

NewSize (String strName, Size newSize) 
Description 

This event will be fired from the diagram control to the containing view when user resizes an object. 
Parameters 





mmm 
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StrName 


String 


Name of the object resized 


newSize 


Size 


New size of the object 
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7 Datasets 

7.1 CFigurelnfo 

- Dataset describing a figure object 









Name 


String 


Figure name (unique within a drawing) 


Position 


Point 


Figure position (coordinates) in the control 


Size 


Size (readonly) 


Figure size; computed based on underlying shapes 


FillColor 


Color 


General figure fill color 


Shapelnfos 


Collection 


Collection of shape infos comprising the figure 


Connectorlnfos 


Collection 


Collection of connector infos 


Constraints 


CConstraintlnfo 


Figure constraints 


CShapeinfo 

- Abstract dataset describing a shape object 








Name 


String 


Shape name (unique within a figure) 


NameLayout 


LAYOUT.TYPE 


Name orientation in the shape 


Position 


Point 


Shape position (coordinates) in the parent figure; 
relative to the parent figure's position 


ZOrder 


Int 


Shape display order 


Label 


String 


Shape label or caption 


LabelLayout 


LAYOUT^TYPE 


Label orientation in the shape 


ShowLabel 


Bool 


Determines if label should be shown or not 


Bitmap 


String (URL) 


Shape bitmap 


RunTimeData 


String (readonly) 


Shape runtime data 


RTDLayout 


LAYOUT^TYPE 


Runtime data orientation in the shape 


ShapeStyle 


CShapeStyle 


Shape style format 



LAYOUT.TYPE - orientation constants 

{ LEFT. CENTER. RIGHT. TOP, MIDDLE, BOTTOM, INSIDE, OUTSIDE } 
SHAPE_TYPE - shape constants 

{ LINE. RECTANGLE. ELLIPSE. CROSS. TERMINATOR} 
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7.3 CShape_Linelnfo 

- Dataset describing a line shape; derived from CShapelnfo 









EndPoint 


Point 


End point (coordinates) of the line figure 



7.4 CShape_Rectanglelnfo 

- Dataset describing a rectangle shape; derived from CShapelnfo 









Size 


Size 


Size (width, height) of the rectangle figure 



7.5 CShape_Eilipselnfo 

- Dataset describing an ellipse shape; derived from CShapelnfo 









Size 


Size 


Size (width, height) of the ellipse figure 



7.6 CShape_Crosslnfo 

- Dataset describing a cross shape; derived from CShapelnfo 









Size 


Size 


Size (width, height) of the cross figure 



7.7 CShape_Terminatorlnfo 

- Dataset describing a terminator shape; derived from CShapelnfo 



^iield!ljalKfft#s: 








mm 


Size 


Size 


size (width, height) of the terminator figure 



7.8 CShapeStyle 

- Dataset describing a shape style format 



i^iiisiiHrii;i^¥P 






BorderColor 


Color 


Outline color 


BorderWidth 


Int 


Width of the border or outline 


FillColor 


Color 


Fill color 
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7.9 CConnectorlnfo 



- Dataset describing a connector 









Name 


String 


Connector name (unique within a figure) 


Position 


Point 


Connector position (coordinates) in the parent 
figure; relative to the parent figure's position 


Size 


Size (readonly) 


Connector size; computed based on underlying 
shapes 


FillColor 


Color 


General connector fill color 


Shapelnfos 


Collection 


Collection of shape infos comprising the connector 


Constraints 


CConstralntlnfo 


Connector constraints 



7.10 CConnectionlnfo 

- Dataset describing a connection 









Name 


string 


Connection name 


StartFigureName 


String 


Name of the starting figure 


Start ConnectorName 


String 


Name of the starting connector 


EndFigureName 


String 


Name of the ending figure 


EndConnectorName 


String 


Name of the ending connector 



7.11 CDiagramControlProperty 

- Dataset describing the control properties 









ShowGrid 


Bool 


Determines if control should show grid or not 


SnapToGrid 


Bool 


Determines if control should snap objects to the 
grid or not 


Gridlnterval 


Int 


Spacing between grid points 


BackColor 


Color 


Background color of the control 



7.12 CDiagramlnfo 

- Dataset describing the diagram 
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Figurelnfos 


Collection 


Collection of figure infos 


Connectionlnfos 


Collection 


Collection of connection infos 


Constraints 


CConstraintlnfo 


Diagram constraints 



7.13 CConstraintlnfo 
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1. Runtime Operator's Workspace Concept 

As a part of the development program, this document describes the concept for collection of 
applications that provide the primary operator interface for the DeltaV system. 
It's goal is to identify user needs in this area, and to define a concept for the set of system 
features that would meet those needs. 

This concept document defines the primary objects and the key actions that can be performed 
on those objects, which users will need to understand in order to utilize the runtime 
workspace.. 

1.1 Objectives 

The objectives for the runtime workspace and applications are to provide superior primary 
operator interface tools for the DeltaV system: 

1 . Highly reliable, "mission critical" application intended for process control operators 
who need to stay in control of the "control system" in all circumstances. 
Characteristics include: 

• Always available. In many cases, the application may be available for long 
periods of time (e.g. weeks, months, even years) without unplanned disruptions. 

• Always interacting. Operator may always have the opportunity to "move on"; 
getting predictable responses to new directives even when previous requests take 
"too long" to complete, or "everything is changing" due to a plant upset. 

• Mistake resistant. Repeatable behaviors and user interaction features that can help 
reduce the possibility of high cost "human errors"; especially in high stress 
situations. 

2. Extremely responsive interactions and high performance display of process 
information. Expectations for large user configured displays to appear and be 
populated with live data from the DeltaV system typically within 1 second. (Smaller 
displays like our pre-engineered "faceplate" style displays correspondingly faster.) 

3. Supports a dedicated (kiosk style) operator environment, which is extremely resistant 
to users damaging the programs or data present on that workstation, or gaining access 
to unintended applications. The degree of restriction is user configurable, so that the 
workspace is also suitable for use by trusted and higher skill level users. 

4. Adaptable to a wide range of user interface hardware features: 

• 1- 2- 3- or 4- monitor video configurations 

• 4:3(PC format) and I6:9(HDTV format) aspect ratio monitors 

• mouse + keyboard operation 

• touch screen operation 

• PDA form factors and user input techniques 

• Tablet PC form factots and user input techniques 

• Smart Phone form^actors and user input techniques 
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5. Excellent integration of operator tools/applications (e.g. Batch, diagnostics, history 
viewing) with user configurable displays (and user display logic). Easy access to 
information related to display elements. Easy access to auxiliary information sources 
(e.g. video feeds) and collaboration technologies (e.g. e-mail and instant messaging.) 

6. Operator-friendly tools to select and manage the content in the runtime workspace; 
minimizing window management responsibilities. Improved features for rendering 
content within the available space, so that a content sources not specifically 
engineered for the workspace are easily usable. 

7. Well integrated user security and authentication facilities to support: 

• Fast DeltaV user switching (comparable to previous systems) 

• DeltaV user collaboration (temporarily aggregating security privileges) 

• Multi-user authentication for electronic signature requirements 

• Authentication technologies that do not require passwords 

• Login timeouts 

8. Platform for improved information capture and analysis tools for operations staff. 
Features like: 

• Snapshot log: recording information for later examination 

• Tools for finding revealing alarms in an alami flood 

• "Back in time" displays: ability to look at displays based on (automatically 
collected, recent) historical data 



1.2 Key Terms 







Display deflnition 


Data (file) that holds all the configurable properties and the 
definition and layout of all the elements used to create an 
instance of a workspace display. Most display definitions are 
created by the display configuration application(s). 


Framework panel 


Rectangular display areas within the workspace framework, 
where workspace displays or worlcspace applications can 
appear. 


Runtime workspace 


The interactive DeltaV application(s) that provide the operator 
interface environment. 


Workspace application 


"Built in" DeltaV applications designed to work within the 
workspace framework, showing information and supporting 
user interactions through framework panel(s). 


Workspace display 


Highly user-configurable content in framework panels that 

typically shows updating process information (DeltaV 
parameters) and graphic schematics of process equipment under 
automated control. Also capable of interactions (changing 
parameter values, opening new displays, starting workspace 
applications, etc.) An instance of an .active workspace display 
is created from a display definition. 


Workspace framework 


The configurable layout of the runtime workspace; how it will 
appear on display hardware. Composed of framework panels. 
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1.3 Execution Environments 

We expect the runtime workspace to be well suited for a number of computing platforms and 
execution environments. 

1.3.1 Single Monitor Workstations 

For the foreseeable future, the runtime workspace will most often be deployed on single 
monitor PCs. This will continue to be a cost-effective (and best performing) platform for 
primary and casual "operator" interfaces for the DeltaV system; oflen the best choice where 
flexible mounting or limited space issues are present. 

13.1.1 User needs 

a) A single display device, approx 4:3 aspect ratio (minimum pixel resolution of approx 
1024x768), or 16:9 aspect ratio (minimum pixel resolution of approx 1280 x 720). 

b) Standard PC keyboard and two button pointing device (usually a mouse) for all 
interaction. 

c) All major features of the DeltaV primary operator interface may be available in the 
single monitor configuration ^ 

1.3.2 Touch Screens 

We can expect a significant number of users wishing to use the runtime workspace with 
touch screen hardware; especially when conditions are not suitable for a mouse as a pointing 
device. Touch screens typically make certain interactions more difficult than they are with a 
mouse: 

• Hitting closely packed small buttons or list items accurately (thus more mistakes are 
quite likely) 

• Features depending on mouse pointer position feedback (e.g. tool tips, context menu 
selection feedback, etc.) 

• Operations requiring "dragging" 

• 2""* button (right click) and 3"* button/wheel operations 

1. 3. 2. 1 User needs 

a) No operations that require a 3"* button or mouse wheel 

b) User configurable "touch screen" preferences that can be applied per 
workstation/session: 

• Confirmation step required before any "single click" parameter writes 

• "Point to move; double point to click" preference for pointer behavior 

• Disable drag operations (implies alternatives are available) 

• Right button alternative (e.g. press and hold time) 

• Large vs. small buttons in workspace applications 

• Font size for selection lists 

• Large (button layout) vs. small (space efficient) preference for workstation dialogs 

c) User configurable large and small button choices in display controls; adequate button 
spacers. 

d) Recommended (and tested) windows appearance settings for touch screen use 



' After an» unless a demo room is handy, the single monitor (laptop) is probably the platform where customers 
will be first exposed to the runtime workspace. 
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1.3.3 Keyboard-less Operation 

We should expect users to sometimes deploy the runtime workspace on hardware tailored for 
harsh/dirty industrial environments; situations unsuitable for a standard keyboard, and a 
hardened keyboard is not cost effective. In other applications, operator interaction 
requirements may be quite limited or infrequent, and the need for a keyboard is not justified 
considering the mounting conditions. 

7.3. J. 1 User needs 

a) Virtual (on screen) keyboards or numeric keypads can be utilized to perform all 
interactions via a pointing device (including touch screen); eliminating the need for a 
hardware keyboard. 

b) User configurable "virtual keyboard" preferences that can be applied per 
workstation/session : 

• Automatically display numeric keypad with all numeric data entry controls (with 
large or small buttons) 

• Automatically display virtual keyboard with all alphanumeric data entry controls 
(with large or small buttons) 

1.3.4 Multi-monitor Workstations 

Process operation problems often cannot be immediately dispatched. They often require 
operators to go through an assessment/make changes/monitor results cycle, that can proceed 
at the pace of process dynamics, and sometimes may need fine adjustments along the way. 

When an operator has several problems occurring at the same time, (s)he is faced with 
staying on top of multiple conditions, progressing at different rates, and probably not in the 
same plant area/unit (and thus not combined in any single display.) Having a larger 
"workspace", capable of simultaneous display information from several "problem areas'* can 
significantly help operators with their responsibilities. 

Anticipating the low cost and significant operational benefits of multi-monitor workstations 
we should expect increasing use of multi-monitor hardware as the primary "control room" 
operator's workstation for DeltaV systems. 

i. J.¥« 1 User needs 

a) The ability to utilize multi-monitor capabilities to show more information, and give 
operators more control over the combination of information on display. 

b) A user configurable means to partition the available monitor screen area (a 
"framework") so that: 

• Displays designed for single monitor workstations can be used effectively on 
multi-monitor workstations. 

• New displays that are called up automatically go to the "default" place, and "fit"; 
without the operator having to manage windows or direct display placement. 

c) Allowing operators to easily control and arrange the combination of displays that 
appear; helping him monitor information related to his current concerns. 
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1.3.5 Smart Displays 

With Windows powered Smart Display devices, wireless communication (rather than cables) 
connect the human interface hardware (monitor/touch screen/keyboard/pointing device) to 
the "operator workstation" PC. DeltaV users may find this technology valuable for: 

• Operations supervisors and other plant management staff with needs to interact with 
the DeltaV system from offices and conference rooms. 

• Roaming "helper operators" in large control rooms. 

• Better able to restrict physical access to critical server workstations (e.g. the PRO+, 
terminal servers workstations, etc.) 

Smart Displays generally have touch sensitive screens, on screen keyboards, handwriting 
recognition and sometimes (optional) keyboard and mouse connections. 

1,3. 5. 1 User needs 

(It would seem that the support for Smart Displays introduces no additional user needs, not 
already required by touch screen and keyboard-less operation discussed above,) 

1.3.6 Tablet PCs 

Tablet PCs (like laptop PCs) integrate the "human interface" hardware (monitor) with the 
(Windows XP capable) "workstation hardware", but add touch sensitive screens, stylus based 
interactions, handwriting recognition, and on-screen keyboards. Users may find this 
technology valuable for: 

• Occasional use, remote "control rooms". (Any closet or shack with a work surface, 
power, and a network connection (or wireless access point near by) can become a 
temporary control room.) 

• Very portable DeltaV Simulate systems. 

Users would probably choose Tablet PCs over Smart Displays/server considering: 

a) Snappier display interaction performance (no wireless comms between application 
and display) 

b) Integrated HW is probably less expensive. 

c) They really want a portable personal computer first; and DeltaV runtime workspace 
platform as a secondary issue. 

i. 3. 6, 1 User needs 

a) Given the potential for intermittent wireless connections, a means to let the user 
quickly know if the data on display is "fresh" or is "stale" due to communications 
breaks. 

b) Support for Tablet PC-style handwriting recognition as a means to complete 
interactions that involve data entry. 

(In other respects, it would seem that the support for Tablet PCs (with the runtime workspace 
software installed on them) would have similar user needs as those already required by 
single monitor, touch screen and keyboard-less operation discussed above.) 

1.3.7 Pocket PC based PDAs 

The size and cost factor for Pocket PC PDAs gives them the potential to be a popular 
platform for interacting with DeltaV systems. Integrated microphone/speaker capabilities 
offer potential for entry and playback of audio commentary. PDA usage possibilities include: 
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• System/device health status monitoring by (highly mobile) supervisory or 
maintenance staff. 

• Real-time access to business (production volume, yields, inventory levels) and/or 
environmental information available from the Delta V system. 

• Ubiquitous access to reference documents (safety procedures, shutdown checklists, 
material safety data sheets, plant drawings, etc.) 

• Task specific operator interfaces for roaming operators (verifying valve positions and 
sensor readings, "watching" a unit as maintenance is performed nearby, etc.) 

• Field device identification (activating the "flash your LEDs" mode to verify physical 
location) and repair operations. 

• Entering comments (including audio) on process equipment during inspection rounds. 

PDA device screen size (<10% (pixel-wise) of a single "full size" monitor) places significant 
constraints on how they can be effectively used with DeltaV systems. Memory limitations 
along with the administrative effort to install/maintain correct (even multiple?) versions of 
Delta V-specific software on hand held devices, suggests minimizing the amount of special 
software that may be maintained on the PDAs^. 

/.5. 7. 1 User needs 

a) Configurable workspace frameworks and displays suitable for PDA screens. 

b) Alarm banner and alarm summary controls designed for very small screens and stylus 
style interactions 

c) Operator comment (data and voice) entry applications^. (Probably optimized so that 
"stock" comments or log entries can be entered with minimum virtual keyboard use.) 

d) Minimum software installation and version management administration for PDA 
users. 

(In other respects, it would seem that the support for PDA devices would have similar user 
needs as those already required by single monitor, touch screen and keyboard-less 
operation discussed above.) 

1*3.8 Smart Phones 

1.4 Workspace Desktop Management 

The runtime workspace application(s) will operate in either of the following desktop 
management modes: 

• The "Dedicated and Controlled" desktop 

• As just "Another Windows Application" 

1.4.1 Dedicated and Controlled Desktop 

The "dedicated and controlled" desktop management mode allows DeltaV system 
administrators to deploy the runtime workspace so that its users do not inadvertently (or 
maliciously) damage the software/data installed on that (serving) workstation, nor cause the 
runtime workspace to be inoperative. 



' At this point, use of temninal services technology, thus requiring a (pretty stable) terminal service client 
application on the PDAs, seems like the thinnest possible "thin client", 
' Implies operator comment storage infrastructure. 
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1.4. 1. 1 User needs 

a) It is possible to configure a workstation (or session on a server) to automatically start 
after system boot-up in "dedicated and controlled" desktop management mode. In this 
mode, one instance of the runtime workspace is allowed to run in each workstation 
(session). 

b) A "workspace hard reset" mechanism is required, which causes the run-time 
workspace to revert to the initial startup condition (framework contents) without 
requiring it to be shut down and manually restarted. This is intended as the last resort 
available to operators to restore an (apparently) malfunctioning runtime workspace to 
working condition (short of rebooting the workstation/server). It is acceptable for a 
"workspace hard reset" to take up to 30 seconds'^. 

During the reset, a message should be provided indicating that a reset is in progress, 
along with some updating indication that the screen hasn't frozen. 

c) Certain users should not be constrained to the "dedicated and controlled" desktop 
management mode. Users with appropriate DeltaV security keys, can switch to 
"another Windows application" desktop management mode (retaining as much current 
workspace context (panel contents, recently used history, etc.) as possible. 

d) While in "dedicated and controlled" desktop management mode, users are prevented 
from running unintended programs or applications. This requires: 

• Disabling access to the Start dialog (Windows key and Ctrl-Esc) 

• Disabling access to the Windows taskbar 

• Disabling access to Windows keyboard shortcuts; especially including: 

a. Run dialog (WinKey + R) 

b. Minimize all (WinKey + M) 

c. Switch to another (non-runtime workspace) application (Alt-tab) 

d. OS Explorer (WinKey + E) 

• Not allowing access to Windows desktop shortcuts 

e) The runtime workspace will allow specific (non-runtime workspace) applications that 
have been authorized (via DeltaV configuration). The user will be presented a list of 
applications (and descriptions) to choose from^. 

f) While in "dedicated and controlled" desktop management mode, users are prevented 
from making the runtime workspace inoperative. This requires: 

• Not allowing the termination of the (primary) runtime workspace application (e.g. 
Alt-F4, or Exit menu items) 

• Disabling access to the Windows Security dialog (Ctrl-Alt-Esc) 

• Disabling access to Windows keyboard shortcuts; especially including: 

a. Minimize all (WinKey + M) 

b. Lock workstation (WinKey + L) 



* The intent that this would be a "deep" enough reset to completely clean up and reinitialize the runtime 
workspace and all runtime workspace companion applications. 

Configurers are responsible for choosing non-runttmc workspace applications to run that don't allow the 
operator to alter or delete files, launch still other "unconstrained" applications, etc. 
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• Disabling access the Windows Display Properties dialog (e.g. access to altering 
display color depth and resolution settings, appearance preferences, themes, 
wallpaper, etc.) 

g) The runtime workspace will provide a "constrained Internet browser". While in 
"dedicated and controlled" desktop management mode, web pages from authorized 
(via DeltaV configuration) URLs will be displayed or accessible via hyperlinks^. 

h) While in "dedicated and controlled" desktop management mode, any screen savers are 
disabled. 

i) Runtime workspace compliant applications do not provide access to the Windows 
folder and file properties dialog when performing any file browsing operations. They 
do not allow files to have their properties or security requirements changed, or be 
renamed or deleted, unless doing so cannot possibly damage the software or data 
installed on that workstation. 

1.4.2 Another Windows Application 

The "another Windows application" desktop management mode allows the runtime 
workspace to be used in conjunction with other Windows applications, by appropriately 
authorized and skilled personnel. Switching to this mode is useful for: 

• using the DeltaV system configuration applications (including workspace and 
display configuration applications) 

• gaining access to debugging features not appropriate for all users 

• troubleshooting the runtime workspace 

1*4.2.1 User needs 

a) To aid runtime workspace troubleshooting, the "another Windows application" 
desktop management mode supports all the features and interactive behaviors of the 
"dedicated and controlled" desktop management mode as much as possible. 
Conceptually, it just removes constraints and adds extra features. 

b) While in the "another Windows application" desktop management mode, the user has 
access to the normal Windows desktop application management features; including: 

• Task bar. Start button. Run dialog, etc. 

• Windows key and Windows key shortcuts 

• Application minimization (including the runtime workspace) 

• Application switching (Alt-tab) 

• Unrestricted ability to change display properties 

• The ability to terminate the runtime workspace application(s) 

c) While in the "another Windows application" desktop management mode, there is a 
mechanism to "spin off* a new (detached) Windows application window on the 
Windows desktop, with the same content (display or runtime workspace application) 
as any of the framework panels (fixed or floating). This gives the user the ability to 
easily create content in new windows, where s(he) is responsible for window 
management (positioning, resizing, minimizing/maximizing, scrolling content within 

^ Goal here is to support users who maintain documents and web pages on intra-network servers; and still want 
to prevent uncontrolled roaming on the Internet. 
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the window client area, closing, etc.) Once such windows are created, they no longer 
interact with or "track" actions in the runtime workspace framework. 

d) With access to the Windows desktop, users may "run" new instances of the runtime 
workspace application; choosing for it to start up in either "dedicated and controlled" 
or "another Windows application" desktop management mode: 

• When launched in "dedicated and controlled" desktop management mode, the 
Windows desktop will be controlled by the runtime workspace application, and 
other running applications will (probably) be inaccessible . 

• When launched in "another Windows application" desktop management mode, the 
user may run multiple instances of the runtime workspace application^. 

e) All users may switch from the "another Windows application" desktop management 
mode to the "dedicated and controlled" desktop management mode (no security key is 
required.) The switch retains as much current workspace context (panel contents, 
recently used history, etc.) as possible. 

1.5 Internationalization Support 

Today, most "operations" features of the DeltaV system are available, localized to one of 
several languages. The runtime workspace, being the primary "operations" application, may 
continue to support the current language choices. It should also be expected that not all 
workstation/terminals/PDAs connected to a DeltaV system will want to have the runtime 
workspace use the same language choice^. 

Also, should technical support from EPM/AUS be needed to consult on a non-English DeltaV 
system, the English speaking technical support staff has the option of switching to, or running 
a separate English runtime workspace to facilitate communications^^. 

i. 5. i. 1 User needs 

a) Users may choose one or more of the available DeltaV language options when 
installing DeltaV on runtime workspace-capable workstations or terminal servers. 
One language is the identified as the "dominant" language for the system; determining 
the standard and default confrguration values for that DeltaV system. The dominant 
language may be the same for all DeltaV workstations in the same system. 

b) When an instance of the runtime workspace is started, the dominant language is 
automatically chosen by default, and all standard workspace behaviors and 
interactions use that language. 



^ The user should probably close (or park) them appropriately before starting up a "dedicated and controlled" 
runtime workspace. 

' For example, taking advantage of multi-monitor hardware to use/test several single monitor display 
frameworks running in different instances of the runtime workspace application. Or perhaps run an English 
instance of the runtime workspace in parallel with a non-English instance, to assist English speaking 
troubleshooters. 

' Since most engineering and administrative applications are available in English, it seems quite likely that 
some users will want to run English runtime workspaces in non-English DeltaV systems. (Seems like this could 
facilitate technical support as well.) 

'° We may want to consider always installing English secondary language support on workstations in non- 
English DeltaV systems. 
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c) It is possible to override the language choice for the runtime workspace with 
additional information provided at start up. It is also possible for a user to switch to 
another language for an existing runtime workspace instance by selecting one (of 
those installed on this workstation) in the course of doing a "workspace hard reset" 
operation. 

d) When the workspace is running using a language other than the dominant language 
for the system, the workspace applications provide an interface (menus, dialogs, etc.) 
localized for the chosen language. Information content that is determined by the 
DeltaV system configuration, such as: 

• Area, module, node, DST, FF device names 

• Module, node, FF device descriptions 

• User enum state names 

• Alarm parameter names, alarm words, priority words 

• Batch procedure/recipe names, grade names 

. . .still retain their configured names (presumably compatible with dominant 
language.) 

Also, information stored in common system databases (available to multiple 
workstations/sessions) such as: 

• Event Chronicle databases 

• Batch Historian databases 

• Continuous History databases 

• Device Audit Trails 

...remain, and are displayed using the dominant language for the system. 

1.6 Workspace Framework (Layout) 

The workspace framework provides a user configurable layout for how information is 
arranged within the runtime workspace; utilizing the available display area on the target 
display hardware. We anticipate: 

• Users will often choose one of the pre-engineered frameworks that are part of the 
default DeltaV configuration. Users (or system integrators) with special requirements 
or unique display hardware will design/configure their own framework(s), 

• Once a framework is chosen, it will be widely used within a DeltaV system (across 
many workstations/terminals having similar display hardware). This helps makes 
operators be more effective wherever they are working; and helps reduce training time 
and mistakes. 

• Displays will be designed with the framework (panel) dimensions in mind; building 
displays that will "nicely fit" the panels without a lot of "stretching" distortion or 
having display elements end up being too big (wasting precious space) or too small 
(to read easily). 

• Even when different display hardware configurations are used in the same system, 
users will strive to use similarly sized panels across their frameworks, so that the 
same displays will render nicely on each hardware configuration; avoiding the effort 
of engineering separate displays for each. 

1 •6. 1 Framework Panels 

Framework panels are rectangular display areas where runtime workspace displays or 
applications can be made to appear. There are two types of framework panels: 
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• Fixed panels: have a fixed location in the framework and area always visible (even if 
they have no content). Are not allowed to overlap other fixed panels. The collection 
of fixed panels in the workspace firamework is the visible "background surface" of an 
instance of the runtime workspace application. 

• Floating panels: provide a means for a controlled number of temporary content 
windows that float over (obsuring) other panels. When the content in a floating panel 
is closed, the floating panel disappears. Floating panels may be configured to be 
movable: allowing the operator to move the floating panel away fi-om it's anchor 
point, giving him more control" over the visible portions of all panels. 

i. 6. i. / User needs 

a) Framework panels are capable of showing several types of content at any point in 
time: 

• User configurable runtime workspace (graphic) displays. 

• Runtime workspace applications. 

b) Floating panels in the workspace firamework have a configurable "use order". When 
two closed floating panels are otherwise equally eligible to be selected to display new 
content, the floating panel with higher precedence in the use order will be chosen. 

Fixed panels have a separate configurable "use order" to establish precedence. 

c) Through configuration, it is possible to categorize workspace display definitions and 
firamework panels so that displays of a certain category will be automatically directed 
to appear in a fixed or floating panel with a matching category name*^ when a 
destination panel is not otherwise specified. 

• One firamework panel (fixed or floating) may be configured with 0 or more 
category names. 

• A display definition may be configured with 0 or 1 category names. 

d) It is possible to assign the same category name to several (fixed or floating) panels. If 
a new display's category matches several several panels, the display is directed per the 
sequence: 

• If a fixed panel that currently has no content matches the new display's category, 
the the new display will replace the old content in that fixed panel. Fixed panel 
use order will resolve which fixed panel to use if more than one is eligible. 

• If a floating panel that is currently closed matches the new display's category, that 
floating panel will be opened with the new display conent. Floating panel use 
order will resolve which fixed panel to use if more than one is eligible. 

• If a floating panel that is currently open matches the new display's category, that 
floating panel's content will be replace with the new display. If more than one 
open floating panel matches, the one with the oldest content will have it's contents 
replaced with the new display*^. 

• If a fixed panel matches the new display's category, the new display will replace 
the old content in that fixed panel. If more than fixed panel matches, the one with 



^' At the cost of more window management responsibility. 

Users will lend to define display category names that reflect a combination of native display size and purpose. 
* Supporting "round-robin" distribution of floating displays (of certain categories) to their corresponding 
floating panels. 
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the oldest content will have it's contents replaced with the new display. 

e) It is possible to configure panels to be the automatic "destination" for the workspace 
applications (e.g. diagnostics, batch operations, history view, etc.) 

f) One panel (either fixed or floating) in each framework is the "default destination" 
panel. When no specific panel is identified for new framework content and there is no 
category name match between the new content and any panel, new content appears on 
this default destination panel. 

g) When an instance of the runtime workspace is first started (or goes through a 
"workspace hard reset") initial fixed panel contents are displayed. Each fixed panel 
may have an "initial content" (e.g. workspace display, or application) defined in the 
framework configuration. The configured initial content for fixed panel(s) may be 
overridden with information provided at runtime workspace startup time. 

h) Framework fixed panels may be configured to have several border options to help 
delineate them from other fixed panels in the framework. Options include "no 
border". 

i) A floating panel's upper left comer initially appears at a configurable "anchor point" 
position in the workspace framework. 

j) Each floating panel is configured with a preferred size (height and width). It is also 
configured with a preference for how to choose the intial size: 

• Use native size: the native size of the display establishes the intitial size of the 
floating panel window. (When the content has no "native size" (e.g. workspace 
applications) the floating panel's preferred size is used as the initial size. The 
floating panel display window will be constrained to not go beyond the workspace 
framework. 

• Use preferred size: the panel content is scaled (within any scaling constraints 
defined for the workspace) to fit widiin the preferred floating panel size, with 
possible gaps or scroll bars. 

k) Each floating panel is configured to be resizable or not. If the floating panel is 
configured to be resizable, it's window is rendered with a border suitable for use in 
window resizing operations. If the floating panel is not configured to be resizable, 
window resizing operations are not supported (the floating panel will always remain 
at it*s initial size.) 

1) Some panels in a framework require a mechanism for user interactions with the panel. 
These include: 

• Closing the panel contents (e.g. floating panels) 

• Moving a floating panel 

• Picking the panel as the source or destination for a "copy contents to another 
panel" operation. 

• Panel content scaling or zoom operations. 

• Recall recent panel contents operations. 
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• Open contents as new (Windows task bar) window'^. 

• Capturing a "snapshot" of the current contents. 

• Controlling the display of display layers. 

• Controls involving the "display using historical data" feature 

• Resizing floating panels (without dragging borders) 

• (other operations introduced in the future) 

Also, depending on available space, users may want title or caption information about 
panel contents, for example: 

• Display name 

• Currently selected object (e.g. module, node) name 

Framework panels may be configured to have "information and tool button" bars. 
The content of these bars is configurable. When display area is extremely limited, a 
mechanism is available to let the info/tool bar to be hidden or minimized. 

1.6.2 Workspace Displays 

Workspace displays are the mechanism to provide very customized content (and supporting 
display-related logic) within the runtime workspace. Workspace displays are intended to be 
used for: 

• System specific "process graphic" displays; showing live process information and 
providing a means to manipulate process parameters. 

• Logical "control panels" (or "faceplates") for DeltaV modules, nodes, etc. 

• User customizable "pop-up dialogs" 

• System status and alarm summary information 

• Plant drawings or other documentation that may be annotated with live process 
information. 

(For details on what runtime workspace displays can be composed of, see the "Process 
Display Primitives and Components" concept document.) 

(For details on the features and capabilities of display-related logic, see the ^'Process 
Display Logic and Languages" concept document.) 

1* 6*2* 1 User needs 

a) Workspace displays have names used for identifying them: 

• Users selecting them from display list/tree browsers, wanting to find/open a 
display by name. 

• Used by display elements (like display launch buttons) to open another display 

• Used by display logic to pick the appropriate display for the current conditions 
Restrictions on display names should allow: 

• Them to be long enough to serve as their own description in a list of display 
names (allowing for localized names) 

• Characters that can server as delimiters (e.g. space, hyphen, underscore, etc.) 

• Upper/lower case preservation, but case-insensitive comparisons. 

• Easily reversible conversions to/from legitimate file system names 



When the workspace is in "another windows application" desktop management mode. 
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b) We can anticipate users defining a large number of displays for their DeltaV system. 
To help provide organization of these for the operator, a hierarchical folder/directory 
system should be supported. Since folder/directory names in such a system will serve 
as their own description, the restrictions on these names should be comparable to 
those on display names. 

c) Some workspace displays (especially those creating by importing process 
instrumentation drawings from non-DeltaV applications) are likely to contain display 
elements'^ that are not always appropriate for display under typical conditions. Yet, 
for special conditions (or when used by engineering or maintenance personnel) 
getting access to this information would be valuable. 

Workspace displays will support display elements associated with "display layers"*^. 
The display configurer can segregate information into separate layers, and choose 
which layers are visible by default when workspace displays are first rendered in the 
runtime workspace. 

The runtime workspace will provide a mechanism, at the framework panel level, to 
indicate what layers are available in a display, and change which layers currently 
appear. For each layer, three levels of visibility is supported: 

• Hidden: display elements associated with that layer are not rendered. 

• Subdued: display elements associated with that layer are "ghosted" (configured 
level of transparency) behind any full view layers. 

• Full view: display elements are rendered with their normal (configured) color and 
transparency level (usually opaque) 

d) Workspace displays may be configured to offer special display layers automatically 
created by the runtime workspace. Special display layers provide an mechanism to 
add "smart features'* to user configured displays with little extra display configuration 
work. Special display layers that should be considered include: 

• Auto "module controls" : tiny module "faceplates" appear on top of display 
elements with data links to module parameters. (Automatically "weeding down" 
to at most one faceplate per module.) 

• Auto "trend views": small, semi-transparent real-time trend windows appear next 
to display elements involving numeric data links. Trend windows support 
interactions to quickly delete unwanted ones, drag to better position, increase size, 
make opaque, or launch the a full function process history view application in the 
appropriate panel. 

• Auto "alarm volume history": for each plant area and Unit associated with data 
links on the display, an active alarms by priority vs. time column chart is 
displayed; indicating when and where alarm bursts occurred. 

e) While the "fixed and controlled" nature of the runtime workspace framework is 
intended to relieve operators of most window management activity, for some users it 
may be too rigid. Resolving and monitoring different process problems may call for 

Information appropriate to the original drawing, but has little to do with the Delta V system and the automatic 
process controls; e.g. piping tags, size and materials, manually operated valves, visual inspection points, etc. 
Similar in concept to the "drawing layers" features in CAD applications. 
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more flexibility in using the available display space. 

Specialized "sub-panel" workspace displays may be configured. Though capable of 
containing typical display elements, they are distinct in that they contain panels that 
support the configuration and behaviors of framework fixed panels. 

Sub-panel displays offer a couple of features to help users better tailor the runtime 
workspace to the problems of the moment: 

• By choosing a sub-panel display, the operator can dynamically subdivide one of 
the panels in the framework into a pre-defined arrangement of smaller fixed 
panels. (Consider sub-panel display intended to subdivide the "main" display 
panel, into a row of "faceplate" sized panels on top, and a wide panel ideal for a 
trend window on the bottom.) 

• Once the panel contents have been defined in a sub-panel display, the operator can 
save the display (in temporary user-session display storage) for later use in the 
session. Essentially, instances of new displays, dynamically composed to address 
specific process monitor problems, can be created and reused by that 
user/workstation/session. 

1.6.3 Workspace applications 

Workspace applications are the means to deliver task-specific, optimized, "ready out-of-the- 
box" user interfaces via the runtime workspace. These user interfaces require little or no 
engineering or customization between DeltaV systems. They also offer an opportunity for 
richer user interfaces; ones that would be difficult to accomplish through combining display 
primitives and components and display logic. 

Workspace applications differ from normal Windows applications in that: 

• They communicate with and their lifetime is controlled by the runtime workspace. 

• Expecting not to be "full screen" applications, they take particular care to 
automatically adjust their user interface layout to best fit the panel area they are 
assigned to work within. When used in a floating panel, they make every attempt to 
provide a suitable layout within the initial preferred size configured for the floating 
panel. As the floating panel is resized, they adjust their layout accordingly. 

• They follow the runtime workspace user interface conventions for common actions 
(e.g. selecting, scrolling, scaling, etc.) so the entire workspace feels well integrated. 

• They follow workspace conventions for retaining user interface state, so that "go back 
to last display" operations for panels work well. 

• Where possible they offer useful "tracking" modes of operation; where their 
content/focus automatically follows the system object (module^ node, FF device, 
batch, logic solver, etc.) that has focus in other panels in the framework (usually the 
"main" or "default destination" panel). They offer a means to disable tracking mode. 

We would expect that adding new workspace applications would be used frequently as the 
capabilities of the DeltaV system increases. (See details on each using each workspace 
application in later section.) 
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1.7 Using the Framework 

1.7.1 Optimized Operation Scenarios 

This section explores runtime workspace features aimed at providing excellent facilities for 
handling frequent operator tasks. 



The scenarios assume the following runtime workspace environments and frameworks: 
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A Pocket PC terminal session environment and workspace framework: 
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"MAIN" panel 
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TOOLBAR" panel 



i. 7.1,1 Respond to Alarm in Alarm Banner*' Panel 

1 -7.1 .1.1 Single Monitor Worlcstation Environment 

1 . System has been quiet. Operator has several alarms appearing in the alarm banner, 
but has checked them out and is confident that they will be resolved later in his shift. 
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2. A moderate priority alarm occurs in Reactor 1 . The operator is alerted to it first by 
the workstation making the "WARNING" level alarm (horn) sound. He sees the new 
alarm in the alarm banner. The alarm banner buttons have backgrounds indicating 
age of the alarm (white for very recent, to black for alarms that have been active for > 
8 hours). He quickly know that the one white background alarm has occurred very 
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recently. 



3. Clicking the 4* button beside the button showing the new alarm, he sees a brief 
summary of the alarm that just occurred in the alarm banner. The operator doesn't 
remember seeing this alarm before, so he elects to view the extended alarm 
information display for the selected alarm by pressing the •i+' button. 

The display logic for ttie •i+' button captures the module name ("FIC-lOl") for the 
alarm currently selected in the alarm banner, constructs a calling info string of 
"Display='DvAlarmInfo*; Module=TIC-10r", then passes it to workspace function 
"OPEN_DISPLAY". 

The "DvAlarmlnfo" display was configured with a panel category of 
"ALARMINFO". In the current framework, there is a (floating) panel configured to 
be an " ALARMFNFO" category target, so that floating panel is chosen for the 
"DvAlaimlnfo" display. The display currently open in that floating panel (if any) is 
closed, and an instance of the DvAlarmlnfo display is opened there. 
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The display logic in the "DvAIarmlnfo" display expects a module name to be in it's 
launch information. Finding "FIC-lOl", it uses that name in calls to the data services 
layers to obtain information about FIC-101 and it's containing Unit and Equipment 
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5. Now confident he understands the alarm situation in FIC-101, and its containing 
modules, he closes the "DvAlarmlnfo" floating panel, and decides to look at the 
primary control display for FIC-101; by pressing the button so labeled in the alarm 
banner. 



The display logic for the alarm banner buttons capture the module name ("FIC-lOl") 
and constructs a calling info string of *Tanel='MAlN'; Module=TIC-10r; 
Select="FlC-101"; KeepARScrollOneDim", then passes it to workspace function 
"OPEN_PCD". 

The OPEN^PCD function resolves the primary control display name 
"REACTOR l_TOP" for module "FIC-lOl". It then asks the workspace to resolve 
PANEL- MAIN', and to replace the display currently in that panel with 
REACTOR l_TOP. 

REACTORl_TOP originated through an import of a P&ID drawing from another 
system, so it's native aspect ratio is much wider than the MAIN panel in the current 
framework. The "KeepARScrollOneDim" directive says that the aspect ratio for 
REACTORI^TOP should be maintained while scaling it to fill the MAIN panel, with 
scroll bars for the dimension that wont fit. 

The Select="FIC-101 " directive is forwarded to "REACTOR l_TOP" telling it to 
resolve the "best" selectable graphic object associated with "FlC-lOl" and 
automatically give it selection focus (scrolling the display as necessary so the selected 
object is visible and as centered in the MAIN panel as possible.) 
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The presence of the "KeepARScroIIOneDim" and "Select" directives overrides the 
default workspace behavior which remembers the scaling and scroll position last used 
on a display, for when it is opened again in the same user/session. 

After looking at "near by" alarm conditions and process measurements, the operator 
chooses to make an adjustment to the setpoint on FIC-101, and watch how that 
control loop reacts. The faceplate display is the ideal interface for what the operator 
has in mind, so he pushes the faceplate button in REACTOR l_TOP for this module. 
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(Or since FIC-101 is still in the alarm banner, he could have pressed the faceplate 
button there.) 

The display logic for the faceplate button captures the module name ("FIC-101") 
associated module, constructs a calling info string of "Module=TIC-10r", then passes 
it to workspace function "OPEN_FPD". 

The OPEN_FPD function resolves the faceplate display name 'TID_LOOP_FP" for 
module "FIC-101". The "PID_LOOP_FP" display was configured with a panel 
category of "FP". In the current framework, there are two floating panels configured 
to be an "FP" targets, both are currently empty, so floating panel on the left is chosen 
as it was placed ahead of the other floating panel in the floating panel "use order" 
configuration. An instance of the PID_LOOP_FP display is opened there, passing it 
the launch information: "Module=TIC-10r". 



The display logic in the "PID_LOOP_FP" display expects a module name to be in if s 
launch information. Finding "FIC-101 ", it uses that name in calls to the data services 
layers identify the parameters in FIC-101 it will be reading. 

Several parameter/field values from FIC-101 are used repeatedly in the FIC-101 
display (notably the scaling parameter associated with the PV and SP parameters) and 
for any update cycle of the display it is desirable that the scaling values be used 
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consistently. The "pre-update" logic for "PID_LOOP_FP" read the EUO and EUlOO 
values, engineering units string and decimal places information and stores them in 
"local display variables" which can be referenced by any of the graphic elements in 
"FID LOOP FP". 



In short order, a new instance of "PID_LOOP_FP" appears in the floating panel 
initially located at its anchor point. 

The operator thinks a significant SP change is appropriate (using the nudge up or 
down buttons won't do), so pushes on the button indicating the set point value. 

The display logic for the SP button click is to ask the workspace to provide a standard 
numeric data dialog. The "PID_LOOP_FP" display is designed to also be used in 
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workspaces running on PDAs, so it constructs a parameter info string of 
"InParentDisplay; DockBottom; Title=TIC-101/PIDl/SP.CV'" and passes it to the 
workspace function "NumericDataEntry". 



The NumericDataEntry workspace function sees that the workspace was launched 
with a "ShowKBOnScreen" preference (perhaps running on a hardware where the 
keyboard is not always present), so it chooses an instance of the standard numeric 
data dialog with an on screen keypad. The workspace resolves the dimensions and 
location of this instance of the PID_LOOP__FP display, and locates the dialog box at 
the bottom of the faceplace display. 

8. Operator enters a new value for the setpoint, closes the on screen numeric pad. 

Within a second or two he sees the new value for setpoint reflected in the value shown 
on the setpoint button, knowing that the controller is now using/reporting the new 
value. The mode is in AUTO so he conflrms some changes in the control (valve) 
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output, and shortly thereafter the PV starts moving in the desired direction. Satisfied 
with the change to this setpoint, he closes the faceplate, and monitors the nearby 
process measurements on the primary control display. 

1 .7. 1 . 1 .2 3-Monitor Workstation Environment 

1 . The system has been pretty quiet since the operator came on shift. Taking advantage 
of the 3 monitor workspace, he's been keeping an eye on 3 different parts of the plant 
that where he's made recent changes, and comparing the production totals so far for 
the day with target values. 
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A new alarm appears in the alarm banner. The operator recognizes the tag and 
confirms the module description: his last setpoint change was supposed to fix this, 
but apparently it hasn't. He's familiar with this unit, and goes directly to the primary 
control display by pushing the alarm banner button with the module's name. 

(Like the single monitor scenario, the primary control display appears on the MAIN 
panel, with focus on the graphic element representing the module.) 




3. The operator now believes the problem is really upstream of the module that is 
reporting the alarm. He sees there is more to this process display out of view to the 
left, so he scrolls to bring it into view. He pushes the faceplate button for an upstream 
control loop makes a change, verifies the control action starting to take effect. 

He knows he's going to have to check back on this a few times in the next hour, so he 
decides to put a copy of this display in one of the empty panes in the left monitor: 
• He pushes the "Copy panel content" button in the toolbar over the MAIN panel. 

The display logic behind the button prepares a parameter information string of 
"Panel=MArN" and calls the workspace ftinction CopyPanelContent. The 
Copy PanelContent ftinction captures the display name currently in the 
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specified panel, the launch information used to create that display, and the 
current scaling, and scroll position settings. 

He then pushes the "Paste" button in the information and tool button bar of an 

empty panel on the left monitor. 

The Paste button in framework panels essentially prepares a parameter 
information string of "Panel- <my panel id>*; UseSourceScale", and calls the 
workspace function that "paste copied panel contents" to "this" panel. 

The a new instance of the display, with the original launch information is 
opened in the panel. The scaling of the source display is preserved, but since 
the panel is half the size of the source panel, the view is centered on the center 
point of the source view, and horizontal and vertical scroll bars appear. 
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1 .7.1 .1 .3 Pocket PC Environment 

1 . The system has been pretty quiet so far today. The operations supervisor keeps an eye 
on things as he moves about (in his office, talking with the operators on shift, meeting 
with the production planning team) using his PDA. While they switch over to making 
a new product grade, he likes to keep the "TOP_ALARMS" display open in the 
MAIN panel. (He can always get back to this display by hitting the "Top button 
in the TOOLBAR panel, always at the bottom of the display area. 
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2. While in the break room talking to the new operator, his PDA makes the WARNING- 
level alarm sound. He looks at his PDA and (judging by the white background) one 
new alarm has just occurred. 






i 


J Jl 


1 J 





The ops supervisor knows what should happen when responding to this alarm, but his 
crew in the control room has the ball. Since this can be tricky, he pushes the "i+" 
button to check for other alarms in this module, equipment module, and unit. 
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The display logic for the "i+" button is designed to call up the ALARMINFO 
display for the selected module. Normally the ALARMINFO display would 
be retrieved from the DEFAULT subtree under the display configuration 
storage root directory. However, this workspace was started with the launch 
information "DisplayPref=PDA", so it will attempt to find a display Definition 
named ALARMINFO in subtree named PDA, before looking for it in the 
DEFAULT subtree. It turns out that a version of the ALARMINFO display 
better suited to the display size of this handheld device was found under the 
PDA tree, so it was automatically substituted for the default ALARMINFO 
display. 

Not seeing anything in the equipment module or unit that indicates he should step in, 
he opens the faceplate display for FIC-101, by pushing the faceplate button in the 
ALARMINFO display. 

Shortly after opening the faceplate display for FIC-101, he sees that his crew has 
already acknowledged the new alarm. A bit later he sees a setpoint adjustment (just 
what he would have done.) Confident that the time he's spent in training this crew is 
paying off, he can get back to his conversation in the break room. 
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7. 7. L2 Getting More Information on Display Elements 

1 .7.1 .2.1 Single Monitor Workstation Environment 

1 . The operator has been noticing intermittent deviation alarms on the primary inlet flow 
control loop for Reactor 1 . He's been watching the primary control display for 
Reactor 1 » and it seems the deviation alarm occurs when demand peaks for a few 
minutes. He suspects that at the new production rates they've been running, they are 
expecting too much of the inlet flow feed pump... so he clicks on the graphic object 
representing the pump "VSPNiP-lOl" on the display. 

The pump object in the display had been taken from the standard library of graphic 
objects. It had been configured to be a selection target, and when selected, to indicate 
selection with a dashed box around the pump and the pump's tag string, and also to 
make the button visible that opens the runtime object browser application. 
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2. Clicking on the pump gives feedback that it is selected, and the object browser button 
appears. . .which he clicks on. 

The standard display logic behind object browser buttons is to launch the runtime 
object browser workspace application, passing it the name of the system object it 
represents. In this case a parameter information string of 

"Application='DeltaVRtObjectBrowser'; Object='VSPMP-10r" was created and 
passed to the workstation function "OPEN__APPLICATION". 

The workspace verifies that 'Delta VRtObjectBrowser' is a recognized application. It 
is not currently prepared to run, so the workspace activates an instance of this 
workspace application, forwarding it the parameter information string as if s launch 
information. 
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Upon activation, that instance of Delta VRtObjectBrowser parses the launch 
infonnation, and finding no panel designation, negotiates with the workspace to 
determine the panel it should use, location/dimensions, etc. In this case, since no 
other workspace configuration information was applicable to this application, the 
MAIN panel is selected (it had been configured as the default destination panel in this 
workspace framework). The workspace deactivates the process graphics display 
currently in the MAIN panel, and tells the Delta VRtObjectBrowser that it now has 
control of that panel. 

The 'Delta VRtObjectBrowser* application chooses a layout suitable for the 
dimensions of the panel it's been given. In this case, having a large panel available, it 
chooses a layout that occupies the fiill height of the panel, but since it can't use the full 
width effectively, it uses the right half of the available panel space. 
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He reviews the information about VSPMP-101: 

• The first section has information about this specific pump. The configuration 
guys have been good about putting location and physical ID information in the 
"extended description" for most of physical plant objects; which has come in very 
handy when they have to find them for physical inspections. 



A button is available here to open the "Operations Journal" application, for 
VSPMP- 101. In this case it indicates that there is at least one entry in the O J for 
this device, but it was made some time ago. 

Since AMS was purchased for this system, and VSPMP-101 is a recognized asset 
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identifier in the AMS database, a button to call up the AMS asset viewer 
application also appears. 

• The second section contains information about this type of pump (there are lots of 
these on site). In this case, there are two levels of equipment-type (class) 
information: 

• The more specific class information is about the make and model of 
pump. The configuration guys were nice enough to put in links to the 
manufacturer's operating guidelines documentation... and someone was nice 
enough to take some identification pictures. 

• The more general class information has links to the site training 
documents; standard procedures for starting/stopping our "Type B" variable speed 
pumps (regardless of manufacturer, model, or capacity)*^. Also, the 
Maintenance staff has apparently finished the "first line troubleshooting" 
documents for this kind of equipment. 

• The third section is reference information where this pump (and it's control 
module) fits into the control system (hierarchy). The lists and buttons let you 
move the 'Delta VRtObjectBrowser' up and down through the control hierarchy. 

• The fourth section lets you move the 'Delta VRtObjectBrowser* to upstream or 
downstream objects. 

The operator sees the speed and flow capacity limits for this pump and wonders if 
they are pushing the limits. He pushes the faceplate button in the 
'Delta VRtObjectBrowser' application and the faceplate for VSPMP-101 appears in the 
left floating panel. It looks like the current pump speed is well under the limit 
indicated in the description for this valve. Hmmm. . . 

4. The operator decides to look downstream of the pump, and pushes the view button on 
the single downstream object listed: SSV-101-1 Reactor 1 Primary Inlet Valve. The 
browser shifts focus to this control valve. The operator notices a relatively new entry 
associated with this piece of equipment in the Operations Journal, so he pushes the 
button to call it up. 

5. The Operations Journal application opens in the MAIN panel, replacing the Object 
Browser. The most recent entry for SSV-101-1 indicates that on the last physical 
inspection, the upper limit switch appears to be loose or damaged. (The field tech 
doing the inspection included a photo of the problem she saw.) She said the valve 
appeared to working OK at the mid-range travel position, but feared that it might not 
work correctly at nearly full open. Repair parts are on order. . .expecting repairs to be 
completed on Friday. 

There's the problem! The valve isn't allowing the expected flow rate at our new 
higher production rate. Better leave my own entry in the Operations Journal: 

• The operator hit the "last display" button in the TOOLBAR panel over the MAIN 
panel. The Operations Journal application was replaced by the Object Browser 
application; still with focus on SSV-lOI-1. 

• Since the control valve was part of the FIC-101 equipment module, he just hits the 
view button to move up the control hierarchy. 



Also a good place to access the training documentation on how the faceplates were designed to interact with 
this class of equipment. 
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• With focus on FIC-101, he hit the Operations Journal button to bring up that 
application, looking at the journal entries for equipment module FIC-101. 

• The operator adds his own entry, saying that he is seeing deviation alarms when 
trying to achieve flow rates of 2200 GPM or more, and confirms that the limit 
switch problem found on SSV-101-1 (making a Operations Journal link to the 
other object) seems to be causing the deviation alarm problem at the current 
production rates. 

He knew that his supervisor would be reviewing the recent Operations Journal entries, 
and would let the production planning team know that they shouldn't count on 
maximum capacity of this product grade for the next few days. 

L7.L3 Monitoring Multiple "Hot Issues*' 

1 .7.1 .3. 1 Single Monitor Workstation Environment 

1 . Its been one of those days! Ever since coming on shift, it's been one thing after 
another and some of the operator's changes haven't had the expect results! 

The operator had just finished responding to an alarm by making a setpoint change. 
Satisfied the change was accepted by the controller, he'd like to watch the primary 
control display for a while to make sure things were going in the right direction this 
time! But a few more alarms are pending that need attention too. . .so. . .good time to 
define a "display alert" to watch things while his attention is elsewhere. 

The temperature setpoint change he just made is going to take a good hour to raise the 
temperature on the product in Reactor 1 to the new target. This should be a no-risk 
change, but they'll lose this production run if they don't achieve the temperature target 
for some reason. 

He clicks on the "Add Display Alert" button in the TOOLBAR panel over the MAIN 
panel showing the control display for Reactor 1 . The pointer changes to the "value 
picker" shape and he moves it over the digital temperature measurement value that he 
wants to set the display alert on, and clicks it. The Display Alert dialog appears. 
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2. He decides a "Target Alert" is what he wants, so he leaves that tab selected. The 
parameter that he wants to set the alert on is already filled in (thanks to the value 
picker). He decides to enable an initial delay of 1 hour, before checking that the 
target value had been reached. He enters the target value (720 degrees) and an 
acceptable deviation band (+/- 5 degrees). He sets the alert check duration of 1 hour 
(making sure the temperature doesn't drop or overshoot for at least an hour after the 
target is achieved). Since he doesn't have anything more to do when this alert is 
removed, he clears the "Ack before removing" option. 
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Everything looks fine, so he hits the "Add Display Alert" button. The dialog closes 
and a runtime workspace starts add this new display alert. An hour from now, it will 
start checking that the value for TI/lOl -2/AIl/rN.CV is 720 (+/. 5) degrees, and stays 
there for the next hour. After that point, the display alert will automatically remove 
itself 



According to the production plan for the day, it's time the operator changed the 
blending unit over to making their premium product. After he completes the 
necessary control parameter changes, he recalls that his supervisor said they might 
have some intermittent shortages of Hydrogen icine over the next few days. And he 
remembers from last time that the high and low alarm limits are way too loose for that 
flow stream when running this product grade. 

Having better things to do than watch that flow level for the rest of his shift, he calls 
up the display showing the blending flow streams, and "Adds Display Alert" to the 
Hydrogenicine stream's flow measurement. 

The dialog appears, but this time he switches to the Range Alert tab. He consults the 
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grade formula reference documents and confirms a flow rate of 1 12 GPM for the 
Hydrogenicine stream, so he sets pretty tight upper and low range limits for the 
display alert, so he will learn much earlier if feedstock shortages are causing 
problems maintain the necessary flow level for this product. 

4. He sees that the flow rate of 1 12.2 has already been established so there is no need 
for an initial delay on the display alert. Also, the plan is to be making this product 
until at least the end of his shift, so he clears the alert "duration" time; letting the alert 
check be active until he manually removes it. He's done deflning this alert. 

n After l^g^ai houfs and l^iMI minutes (iniUal delay) 

I FIC-BI-HGCyPIDI/PV.CV ^ stays between: 

within a deviation of [ 0.0 | ^ 

I I For a duration of IIEI^I hours and lil^EI minutes, then alert is removed. 

IMl Acknowledge before removing 
Comment: 



1 1 




Add Display Alert jj 



5. The operator also sees on the production plan that he needs to move some finished 
product from intermediate storage to the distribution storage tanks. These are BIG 
tanks (relative to the piping) so these operations take a long time and they didn't 
invest in automatic controls. 

The operator pulls up the tank farm process display, and uses the Object Browser 
Application to get the link to the product movement procedure checklist. After 
manually opening and closing the appropriate block valves, he starts the pump and 
verifies a steady flow measurement as the product is transferred. The production plan 
is to achieve a level of 360 inches in the destination tank, and the plan calculated that 
at the target flow rate, that level will be achieved in 12 hours. 

With no discharges planned, operator expects a steady increase of the level of the tank 
from its present measurement, to the target over the next 12 hours. Rather than set a 
Target Alert (with no checking going on for 12 hours) he chooses a Ramp Alert, 
which will be checking for a steady "ramped" measurement throughout the next 12 
hours. 

Since the next shift operator will need to shut off the transfer pump and close valves, 
he checks "Acknowledge before removing" so the completed alert will get the next 
operator's attention. He also adds a comment to remind them what needs to be done. 
He's done setting up this display alert. 
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6, To check his Display Alerts he's set up, the operator presses the "Display Alerts 
Status" button in the ALARMBANNER panel. This button replaces the content of 
the MAIN panel with the Display Alerts Status application. 

7- He sees the three display alerts he's set up. . .the alert rules look OK. He notices that 
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two of them are running already (since he didn't configure a initial delay on them) and 
they are reading values which are currently on target. 

8. Sometime later, as his attention is on another section of the plant, the operator sees the 
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9. He sees all three of his display alerts are running now, but the flow value on the 
Hydrogenicene stream is not staying in the range he needs it to be in. It is the one 
showing un "unacked" status (and is sorted to the top of the list), so he acknowledges 
it, and presses the button to bring up the primary control display for that control 
module to make some compensating control parameter changes. Later, he comes 
back to the Display Alerts Status display, and pushes the "Change Display Alert" 
button for this display alert. It's done it's job, so he uses the Change Display Alert 
dialog to remove it. 



10. During the next shift, the new operator pushes the Display Alerts Status display 
button to review what the previous shift had left him. He sees a single display alert 
left over, so he presses the Show Details button to get the full scoop on it: 



Display Alerts: Off target: Was off target: On target: 
Initial delay: 

Running: 0 0 1 

Complete 0 0 0 

Unacked: 0 0 0 
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Product Storage Tank 23. Level. 
Display alert set at 12:42 by lUDLEY . 

TANK FARM: " . . ' " • 



1 1 . The operator thinks "Good ol' Ridley lookin* out for both of us!". He checks the Daily 
Production Plan and sure enough all the details for the product transfer is listed under 
item 21 . He*s got a couple of hours before he needs to come back to this, so he goes 
on about his business. 



12. After a couple of hours, the operator notices the Display alert indicator in the alarm 
banner area had turned white and began flashing. He opens the Display Alert Status 
display, and sees that the display alert indicates it*s completed, and needs 
acknowledgment 



He acknowledges the completed display alert (which will remove itself shortly). He 
presses the button for the primary control display for LI-TF1-PRD23 so that he can 
stop the transfer pump and reset the transfer valves. 
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1.7. L4 Responding to an "Alarm Flood*' 



1 .7. 1 .4. 1 Single Monitor Workstation Environment 

I. Things had been going pretty well, but a big lightning storm blew through and the 
new alarms are flying through the alarm banner and Event Chronicle faster than the 
operator can keep up with. He pushes the button in the TOOLBAR panel for the 
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The alann profile charts indicate active alarm counts, stacked by priority, and charted 
over the previous hour. Just as he thought, there had been a lot of new alarms; all 
pretty much in the last 45 minutes. The topmost chart shows the active alarm profile 
for all (active) areas under his control (alarm management scope), and it automatically 
shows charts for each of the five most active plant areas. He quickly sees that nearly 
all the new alarm occurrences are coming from AREA_A, so he presses the "Expand" 
button for that area to drill in for more detailed charts. 



The Alarm Profiles application changes to focus on AREATA, which becomes the 
topmost chart, with the charts for the 5 most active units/equipment modules in the 
plant area. Again it shows that nearly all the new alarms are coming from the 
REACTOR_l unit. He pushes the "List alarms" button for REACTOR_l, and a list 
of all active alarms associated with that unit, that occurred within profile time window 
(the previous hour) appears in the right side of the display. 
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Too many alarms for fliem all to show. Hmmm. ..it looks like the leading edge of the 
alarm burst occurred about 45 minutes ago (the 4* bar in the chart for REACTOR_l) 
so he clicks on the that bar in the chart, and the alarms that occurred during that time 
interval are highlighted in the alarm list: 



AREA A WW 
— AlanOK 21 18 1^ 
^ Inchait 17 16 l»i 




■ 


1 


Active Unack . 


Top AREAS: 







Recent Alann Profiles 



O 0 

Alarms in previous I hr 



Active alanns: previous 1 br 
REACTOR,! 




BIIIGJJIBili!! 





Occurred 


Module /Alwm 




xx:xx xm 


XXXXXXXXXX/XXXXX_ALM 


p 


xx*jcx xin 


XXXXXXXXXX«XXXX_ALM 


m 


xx!xx xin 


XXXXXXXXXX/XXXXX.ALM 


M 




XXXXXXXXXX/XXXXX^ALM 


M 


.xx:xx xm 


XXXXXXXXXX/XXXXX.ALM 


1.. 

t. . 


xx:xxxm 


XXXXXXXXXX/XXXXX_AJLM 


m 


1 'xx:xx xni 


'XXXXXXXXXX«XXXX_AJLM 




xx:mx xm 


XX XXXXXXXX/XXXXX.ALM 


P 


[ xx:xx xm 


XXXXXXXXXXOCXXXX_ALM 


m 


1 xx:xx xm 


XXXXXXXXXX/XXXXX.ALM 


ID 


1 xx:xx xm 


XXXXXXXXXX«XXXX_ALM 


m 


1 xx:xx xm 


XXXXXXXXXX/XXXXX_ALM 


lea 


1 xxrxxxm 


XXXXXXXXXX/XXXXX_ALM 


i 




XXXXXXXXX}UXXXXX„ALM 



392 



Now he's closing in. Using the buttons, he pops open the DvAlarmlnfo display 
for each of the highlighted alarms to get the full details. It's looking like a couple of 
I/O failures (right after that big lightning strike?) tripped the first alarms, then a 
couple of deviation alarms came soon after that. Now looking at the newer alarms in 
the list, he's beginning to suspect that most of them were caused indirectly from those 
I/O failures, and the control actions the system then took to abort an SFC that was in 
progress. 

To get a another view on the alarm profile for REACTOR_l , he presses the "primary 
control display" button for it. Yup, quite a few alarm Indicators on this display. He 
pushes the "Advanced Display Features" button on the TOOLBAR panel, and selects 
"Display Layers". A dialog appears showing the layers configured for the current 
display (in the MAIN panel) and their visibility status. He doesn't see any layers in 
the display that aren't already being displayed (sometimes the display guys will put in 
a specific layer to show alarm information. . .but not this time.) 

So he goes back to the "Advanced Display Features" dialog and now selects "Add 
Alarm Profiles". This causes the runtime workspace to find the graphic elements 
associated with unit and equipment modules, their location on the screen, and creates 
a temporary display layer for the existing display which shows active alarm profiles 
for each major equipment grouping. The other layers in the display are subdued 




Fri 10:23:34 AM RC-IOI/HLALM 



I Reactor I Primaiy Inlci Flow | Hi | WARNING 



(semi-transparent) to make the alarm profiles easier to see. 



5. The operator quickly sees the parts of the REACTOR_l unit which have been quiet 
(alarm-wise) over the last hour, so he can stop worrying about those. It also appears 
that the burst of alarms in the downstream EMs in the unit followed the burst of 
alarms in the upstream EMs. The operator is gaining confidence that the alarm flood 
is due to a single chain reaction through the unit, and now he knows pretty clearly 
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TANK FARM: 



where and when the chain reaction started. 



He pushes the Alarm Summary button in the alarm profile for the most upstream EM 
in the chain, to start sorting out the secondary effects. 



1.7.1.5 Using History Data 

1 .7. 1 .5. 1 Single Monitor Workstation Environment 

1 . The operator had just gotten on shift, and got a quick rundown on what was going on 
from the previous shift before they hurried out the door for the "watering hole*'. 
Alarm-wise, the system was pretty quiet, but he noticed some hard to explain swings 
in some of the flow measurement surrounding REACTOR_l. "Time to get some 
'historical perspective"', he thinks. 

While he has the primary control display for REACTOR_l in the MAIN panel, he 
presses the "Add Trend" button in the TOOLBAR panel. The pointer changes to the 
"value picker" shape and he moves it over one of the digital flow measurements that is 
in this display, and clicks it. 

The workspace resolves the digital value clicked to be a data link to FIC- 
lOl/PIDI/PV.CV Since the maximum for trend pop-ups configured for this panel has 
not been exhausted, the workspace creates a trend pop-up for FIC-101/PID1/PV,CV 
immediately beneath the digital value clicked on. 

The new trend pop-up is logically attached to the current display in the MAIN panel; 
closing when the display goes away, reappearing when that display appears via 
"last/forward" display operations. 

2. The operator sees the trend pop-up for the digital value he clicked on. He repeats this 
process to create trend pop-up for another flow measurement (in FIC-102) on the 
same display. He drags them bit so they don't cover other information on the display 
he wants to see: 
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Looking closely at the trend pop-up for the FIC-101 flow measurement He sees the 
history data for the last hour plotted. He knows trend pop-ups auto scale, but never 
auto scale to show more than 10% of the full EU range, and in this case, since the 
plotted values have scaled to a small band in the center of the plot, they can*t have 
changed by more than 1-2% in the last hour. Nothing interesting here, so he hits the 
close button to dismiss this trend pop-up. 
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4. He turns his attention to the trend pop-up for the FIC-102 flow measurement: 




He sees data for the last hour (the default configured for trend pop-ups for this panel) 
but this time the data occupies the full horizontal area, so he nows it's been changing 
by 10% of full scale (or more) over the last hour. . .Hmmm. He also sees: 

• The plotted data continues to update: the plot is in "real-time" mode 
(confirmed by the icon in the control bar). 

• The background shading helps him quickly see the minimum and 
maximum values in the period plotted. (The configuror chose a warm 
color for the periods where the value was rising between first/last and 
min/max values; a cool color for when the value was falling. 

• The horizontal reference dotted line for the current value helps him see 
that for most of the last hour, the values have been less than what they are 
now. 

6. "That was quite a dip about a half hour ago!" To check the value for a longer time 
period he clicks on the period button in the control bar, and it cycles to a 2 hour view: 




"No, nothing much intering back there", as he clicked the the period button cycling to 
4 hours and 8 hours, and then back to 1 hour. 
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7. "I wonder what that low reading was" as he clicked on the plot in the vicinity of the 
low point The pop-up layout changes to shrink the plot area a bit, show a vertical 
plot cursor, and a legend bar indicating the value and relative time to the sample under 
the plot cursor: 



8. 
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He can tell by the horizontal cursor value reference line that he didn't quite hit the 
minimum, so he uses the keyboard arrow keys to nudge^^ the plot cursor back a 
couple of samples until he sees the "minumum value" icon appear in the legend bar. 

"Ouch!", he thinks. "That was a pretty low flow value for a bit there.. .and it dropped 
fast!". How much, how fast? He lets the trend pop-up do the math: he right clicks on 
the sample just before the value dropped, and the reference cursor appears, and the 
legend bar changes to show the "two data points delta" representation: the change in 
value and time interval between the two cursors: 
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"Hmmpf! 1 wonder if the downstream flows saw this disturbance?" he thinks. So he 
scrolls the display in the MAIN panel to the left to show more of the downstream 
process equipment. He drops a few more trend pop-ups on some of the flow 
measurements in that part of the process, and in some he sees some unexpected 
patterns also. 

"This ain't right! Time to build me a real trend display to keep on top of this." So he 
picks the menu on the TOOLBAR display and navigates down to the "Build New 
Trend Display" menu item. A new template trend display appears in the MAIN panel. 
The template has four faceplate sized (sub)panels on the top and a "History View" 
gadget (control) occupying the lower half of the display area: 



' Or double clicking near the bottom of the plot area (or something elese) to easily select the minimum value in 
range. 



398 



xxxxxxxxx: 



J xxxxxxf_ 



J xxxxxxxxx:[[ 



TIC-IOI-2J432 



m 



Fri 10:23:34 AM FIC-lOl/Hl ALM 




I Rcacior 1 Primary Inlet Flow 



WARNING i+ 



11. "Yup, that's what I want"... so he hits the "Back Display" button in the TOOLBAR, 
and the previous process graphic reappears in the MAIN panel (complete with the 
trend pop-ups that he had created on that display). He hits the "COPY" button on one 
of the trend pop-ups that shows the flow disturbance, then "Forward Display" in the 
TOOLBAR and then the "PASTE" button in the History View control. The control 
shows a larger trend trace for the flow value he'd copied; all set up to show the same 
period (last hour) and scale as he had copied from the trend pop-up: 
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12. He sees there are no event symbols shown for FIC-102 for the period... so he's assured 
that there were no alarms, failures, or downloads of the module that might be related. 
He decides to repeat the "Back. . .Copy trend pop-up. . .Forward. . .Paste to history 
control" sequence a couple more times to place the three odd trends he*d found on the 
trend pop-ups on the same chart. 
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13. "The boss isn't going to believe that the FIC-108 flow peaks like that. I told him the 
blending controls go goofy when we have disturbances like these." He knows what 
the process engineer is going to ask for when they meet to discuss this problem. . .so 
he clicks on the minimum value button for FIC-102, which sets a chart cursor, and 
clicks on the maximum value button for FIC-108, setting another chart cursor. With 
the two cursors set, the chart now shows the clock time for the two cursors and the 




14. "That's what Tm talkin* about!" He hits the Copy button on the trend control, then 
clicks on the button to open the Operations Journal, creates a new entry, and hits the 
paste button. An image of the trend control appears in the Journal entry, and the three 
module names in the the trend control image are automatically added to the "Keys" 
list for this journal entry (so other folks on site will be able to find this entry looking 
for information related to any of these modules). He chooses a entry type and priority 
for this journal entry, and chooses the appropriate "Route To" lists for this type of 
thing... adds a few brief comments of his own and completes the entry. 

15. "Probably worth keeping an eye on this for the rest of my shift" he thinks... so he hits 
Last Display to get to the process graphic, opens two faceplates (floating panel 
displays) for the two flow loops he's most likely to need to tweak, hits forward display 
to get back to the trend template. He then copies and pastes the two faceplates into 
two of the empty subpanels on top of the trend template, and hits the "Save Panel 
View" button. A dialog comes up to prompt him for a name for the (session) trend 
display he just created, suggesting "HalfTrend^Wed 10:58". He overtypes part of the 
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name making it "FIC102nlO8Trend_Wed 10:58" and dismisses the dialog. (Later in 
the shift, he uses the Open Display browser, selects the session displays, and picks 
this trend display he'd saved earlier,) 

1.7.2 Displays and Workspace applications 

While workspace displays and applications produce their displayable content through 
different means, they share space in the workspace framework. Usability is improved if they 
share certain features and behaviors. 

7. 7.2, 1 Representing Information in the Same Way 

It is desirable that the representation of certain kinds of information can be made consistent 
between the "built in" workspace applications and user configurable workspace displays. 

1.7.2.1.1 User Needs 

1 . It should be possible to configure a system-wide mapping of alarm priority values 
(currently 3-15) to "background colors" and suitable "foreground colors". 

• Workspace applications that use color encoding to indicate alarm priority 
should use this configuration. 

• It should be easy to configure the color selection properties of graphic 
elements in user configured displays to use this configuration. 

• Pre-engineered displays that use color encoding to indicate alarm priority 
should use this configuration. 

The implication is that if users change the system-wide alarm color mappings, that 
when that configuration is distributed, subsequent uses of workspace applications and 
displays that use the color mapping automatically follow the changes. 

2. It should be possible to configure system-wide preferences for indicating unavailable 
data, when displaying data that is normally reflecting values that update in real-time. 
Configurable preferences should include: 

• An optional "unavailable data" background and foreground color override and 
opacity. 

• An optional "unavailable data" string substitution character. 

It should be easy to configure "data link" type graphic elements in user configured 
displays to use these system wide preferences if desired. Pre-engineered displays will 
utilize this configuration to appropriately indicate unavailable data. Workspace 
applications that show values that update in real-time should use this configuration as 
appropriate. 

3. Certain parameters related to DeltaV I/O and control functions have a "status" (ST) 
field, used to indicate data quality and certain control conditions. It should be 
possible to configure a system-wide preferences for indicating values with abnormal 
ST fields. Configurable preferences should include: 

• An background and foreground color overrides for ST field bit values. 

• An optional suffix string appended to the CV field strings when there is an 
abnormal ST field. 

• Precedence of ST field bit values when more than one abnormal condition is 
present. 

It should be easy to configure "data link" type graphic elements in user configured 
displays to use these system wide preferences if desired. Pre-engineered displays will 
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utilize this configuration to appropriately indicate abnormal ST fields. Workspace 
applications that show data with ST fields should use this configuration as 
appropriate. 

/. 7.2.2 Runtime Workspace Health and Connection Status 

The runtime workspace often serves as the connection operators have with the DeltaV 
control system(s) under their responsibility. They have an expectation that abnormal process 
conditions (alarms) will be indicated within very few seconds after they are detected in the 
system, so that problem analysis and (hopefully) resolution can begin very quickly. 

While the mntime workspace is the top of many layers of services and computer servers, it is 
important that operators be able use it to quickly determine if the workspace is working 
normally, the hosting workstation service layers are operational, and that communications 
with the ACN is intact. 

1.7.2.2.1 User Needs 

1. A "workspace fault" data source should be provided. Any severe faults detected in 
this instance of the runtime workspace, or instance-specific service layers, would 
cause this data source to have a "bad" value^^. The intent is that when this indicates 
"bad", the operator is encouraged to perform a "workspace hard reset" operation 
(when the opportunity comes), in an attempt to clear the problem. If this does not 
clear the problem, the recommended action would be for the operator to move to a 
backup terminal or workstation. 

Workspace hard reset operations clear this indicator; at least until another workspace 
instance fault is detected. No operator acknowledgment is necessary. 

It will be possible for users to configure displays with data links to the "workspace 
fault" data source. "Workspace fault" will be indicated on the appropriate pre- 
engineered displays (e.g. the standard alarm banner display). 

2. "A workstation/server fault" data source will be provided. Any severe faults in the 
primary services supporting this workspace instance would cause this data source to 
have a "bad" value. The intent is that when this indicates "bad", the operator should 
seek to havie the primary services restarted or the workstation rebooted in an attempt 
to clear the problem. If this does not clear the problem, the recommended action 
would be for the operator to move to a backup workstation, or to a terminal served by 
another workstation/server. 

Restarting primary services clear this indicator; at least until another fault is detected. 
No operator acknowledgment is necessary. 

It will be possible for users to configure displays with data links to the 
"workstation/server fault" data source. It should also be possible to indicate the 
workstation name for which the fault is being indicated. "Workstation/server fault" 
will be indicated on the appropriate pre-engineered displays (e.g. the standard alarm 
banner display). 



Intermediate level(s) between "good" and "bad" may be appropriate, depending on the final implementation. 
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3. An "ACN connection fault" data source will be provided. Loss of regular 
communications ability^* with any (other) ACN node in the local zone would cause 
this data source to have a "bad" value. The intent is that when this indicates "bad", 
the operator should seek assistance in resolving network communications problems 
with the servers connecting him to the ACN, and to a backup workstation using an 
alternate connection route. 

This indicator will clear when a viable communications path has been reestablished. 
No operator acknowledgment is necessary. 

It will be possible for users to configure displays with data links to the "ACN 
connection fault" data source. It will be indicated on the appropriate pre-engineered 
displays (e.g. the standard alami banner display). 

4. A seconds-resolution, current time data source will be provided. The time will reflect 
the "operating system" time on the workstation providing primary services for this 
runtime workspace. The intent is to provide a convenient (predictably updating) 
"heartbeat" graphic element that operators can use to gain confidence that the services 
supporting the other real-time updating values are still "working". 

It will be possible for users to configure displays with data links to the "current time" 
data source; while providing choices for formatting and local vs. UTC time. It will be 
indicated on the appropriate pre-engineered displays (e.g. the standard "tool bar" 
display). 

7. 7.2.3 Rearranging Displays and Applications 

Runtime workspace features for rearranging displays and workspace applications let 
operators control the overall workspace content to match the task at hand. Objectives are: 

• Predictable and repeatable behavior (important when operators are stressed) 

• Minimize the effort involved in repositioning content 

• Eliminate the need to manage (find, show, close, etc.) hidden content (windows) 

1,7.2.3.1 User Needs 
Panel Content 

1 . It will be possible to "close" the contents of a panel. Closing the content in a floating 
panel causes the floating panel window to disappear. Closing the content of a fixed 
panel causes the fixed panel to be displayed in it's configured background color. 

2. It will be possible when configuring a fixed panel, to designate it that it*s content 
cannot be closed. The content of such a fixed panel can be replaced by other content. 

3. It will be possible to configure a button in user configured displays to close the 
current panel^^. 

4. All workspace applications provide a means to close themselves (i.e. their current 
panel). 

5. If a panel is configured to have an "information and tool button" bar, one of the 
standard tool buttons that users may put in the bar is a "close this panel" button. 



Including through any intermediate server "hops" in the communications topology. 

A "close this panel** bunon would be a good candidate for the pre- engineered graphic element library. 
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6. To better support user configured toolbar displays, it will also be possible to configure 
a button in user configured displays to close another fixed or floating panel, identified 
by panel name. If the panel name can be resolved, the panel will close it's display or 
workspace application content. 

7. Each panel can have at most one "open" content. When new content is opened (or 
pasted) to a panel, the previous panel content is automatically deactivated. 

8. It will be possible to "copy" the content of a fixed or floating panel (display and most 
workspace application) and "paste" that content another panel. State information 
(layers visible, view center, scale, tree expansions) is also copied so that the copy 
renders as much as possible like the source panel. 

9. It is possible to configure a "copy this panel" button in user configured displays. 

lOv Workspace applications which support copying to another panel provide a "copy this 
panel" button. 

1 1. If a panel is configured to have an "information and tool button" bar, one of the 
standard tool buttons that users may put in the bar is a "copy this panel" button. 

12. To better support user configured toolbar displays, it will also be possible to configure 
a button in user configured displays to copy another fixed or floating panel, identified 
by panel name. 

13. It is possible to configure a "paste to this panel" button in user configured displays. 

14. If a panel is configured to have an "information and tool button" bar, one of the 
standard tool buttons that users may put in the bar is a " paste to this panel" button. 

15. To better support user configured toolbar displays, it will also be possible to configure 
a button in user configured displays to paste to another panel, identified by panel 
name. 

16. The use of a "paste to this panel" button "consumes" the copied panel information. 
Subsequent "paste to this panel" actions have no effect on the destination panel, until 
after another "copy this panel" action is performed. 

Floating Panels 

17. When new content is opened in a floating panel, the the previous content of the 
floating panel is deactivated. The number of floating panels configured in a 
workspace fi^mework determines the maximum number of floating displays that can 
be open at one time. 

18. All floating panels appear with a control bar docked to the top edge of the user 
configurable portion of the floating display. The control bar always has a "close this 
floating panel" button. 

19. Floating panels initially appear positioned at their anchor point (i.e. the top left comer 
of their control bar is located at the anchor point position.) Ideally anchor points are 
configured so that for the floating displays designed to appear there, no repositioning 
is necessary (not on monitor boundaries, clipped off, etc.) However, the operator will 
be allowed to reposition floating displays; anywhere in the bounds of the workspace 
fi^mework when the firamework is in "dedicated and controlled" mode. 
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20. Floating panels may be repositioned by mouse dragging. The drag souice is the 
control bar (anywhere not occupied by a button). 

2 1 . Since free repositioning of floating panels could lead to some undesirable 
consequences (obscuring panel contents that should always be visible, "lost" floating 
displays, etc.), it will be possible configure workspace framework setting where 
floating display repositioning is disabled. It will be possible to override this 
configuration setting in the launch information for the runtime workspace. 

22. It will be possible to configure individual floating panels so that they offer no means 
of moving and/or resizing. 

23. If there are multiple floating panels configured with a "category" that matches the 
content in a floating panel, the content may be reassigned to one of the other matching 
floating panels. 

24. Up to four (left, right, up, and down) "reassign to next floating panel" buttons my 
appear (space permitting) in the control bar, depending on the number of eligible 
floating panels for this display. The button faces are chosen to indicate the relative 
direction of the anchor point for the floating panel they would reassign the display to. 

25. When a "reassign to next floating panel" button is selected, the floating panel content 
(along with it's state information) is moved to the closest eligible floating panel in that 
"direction". If the destination floating panel was already open, it*s old content is 
deactivated. 

Sub-panels in Displays 

26. Users may configure specialized "sub-panel" displays. Panels in sub-panel displays 
have their own information and tool button bars, that include at least the standard 
buttons for: 

• "close panel content" 

• "copy panel contents" 

• "paste to panel" 

27. Sub-panels in sub-panel displays support the same close contents, copy contents, and 
paste behaviors as described for framework fixed panels. 

L 7.2, 4 Pop'up Dialogs and Menus 

In most cases, display area is too precious to waste on user interface elements for infrequently 
used actions. Pull down and cascading menus are an effective backup to tool button bars 
when button space runs short. For more complex interactions, specialized pop-up dialogs, 
launched "in context", provide an space-optimized user interface. 

1.7.2.4.1 User Needs 
Pop-up Dialogs 

1 . To conserve display area, certain user interface actions are best performed by "pop- 

' up" dialogs, (e.g. changing mode in a module function block, adding a display alert, 
etc.) The runtime workspace provides a number of "hard-wired" pop-up dialogs to 
accomplish certain actions, and configurable pop-up dialogs may be created^^. 

2. Pop-up dialogs float over workspace fixed panels and compete with floating panels in 
the z-order. 

3. Pop-up dialogs have no default position configuration, nor are they matched up with 
anchor points. Ideally they should initially appear next to (to the right of) the button 



No doubt that some of the pre-engineered displays provided will also use some pre-engineered (though re- 
configurable) pop- up dialogs. 
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or other graphic element that caused them to open, in order to reinforce the "context" 
of which they are a part. Their positioning is constrained so that they never go off the 
edge of the workspace. 

4. In most cases, pop-up dialogs should not be modal (thus allowing interactions with 
other parts of the workspace while they are on display). It is possible for user 
configured pop-up dialogs to be designated as modal, but generally this should be 
avoided except for delivering critical messages to the operator that require immediate 
attention. 

5. Pop-up dialogs have a control bar (one is attached to the top of user configurable 
ones) which provides a mechanism to close the dialog. It may often be appropriate 
that closing the dialog also occurs by other dialog interactions (e.g. "OK" button 
performs some action AND closes the dialog). 

6. Pop-up dialogs that lose their "parent context" (i.e. the graphic object that launched 
them (fixed panel display, floating panel display, parent pop-up dialog) is closed) are 
automatically closed. 

7. Since most pop-up dialogs are not modal, the number of open pop-up dialogs could 
get out of control. Therefore, any "parent context" for a pop-up dialog (fixed panel 
display, floating panel display, or a parent pop-up dialog) is constrained to have at 
most one immediate child pop-up dialog open at a time. If a parent context attempts 
to open another pop-up dialog while another is already open, the earlier pop-up dialog 
is first closed before opening the new one. 

8. Pop-up dialogs may be repositioned while they are open. The may be repositioned by 
mouse dragging; the drag source is the control bar (anywhere not occupied by a 
button). 

9. However, non-modal pop-up dialogs (especially ones that don't display the contextual 
information) that are repositioned far from their parent context could create a 
confusing situation for the operator. By default, repositioning is limited so that some 
part of the pop-up dialog may (slightly) overlap the parent context that opened it. 
Optional positioning hints provided by the graphic element (display logic) that opens 
a pop-up dialog can override the default behavior, by specifying either "no 
repositioning" or "unlimited repositioning". 

10. Repositioning a pop-up dialog with subordinate pop-up dialogs is allowed (subject to 
the repositioning constraints). When this occurs, the dialog and all of its subordinates 
are repositioned by the same amount. Again, repositioning of all pop-up dialogs is 
constrained so that they never go off the edge of the workspace. 

11. Pop-up dialogs associated with fixed or floating panel displays which are copied and 
pasted, are NOT also copied. 

User Configurable Menus 

We can anticipate a number of situations where users (and we) would like to provide more 
command options than there is room for buttons. Also, beyond a certain number of buttons, 
the button icons become indistinguishable, and most users need "tool tips" text to assure them 
they are about to activate the intended thing. 
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We can expect to face this problem in workspace applications, and a menu system is an 
effective and familiar solution. User configurable menus are tools to solve this problem in 
user-configurable (and pre-engineered) displays and workspace framework operations. 

12. It will be possible to configure menu objects for use in the runtime workspace. These 
are named objects (like display definitions) which can be used in one or more contexts 
in the runtime workspace. We expect them to be used for: 

• Cramming more action "buttons" in space limited area (including information and 
tool button bars) 

• High density display launching lists 

13. Menu objects consist of a collection of top level (peer) menu items. Each menu item 
has: 

• A menu item description string (used to select the menu item) 

• (Optional) icon bitmap 
Either: 

• a list of subordinate menu items (and menu list spacers) 

or 

• a menu item availability expression (default is "TRUE") 

• a menu action 

14. It will be possible to configure buttons in user configured displays to "open" a menu 
object, by name. The menu object is displayed adjacent (by default immediately 
below) to the button that launched it. 

15. It will be possible to configure buttons that appear in framework panel information 
and tool button bars and floating panel control bars to "open" a menu object, by name. 
The menu object is displayed adjacent (by default immediately below) to the button 
that launched it. 

16. Menu object operation is similar to window menus. Depending on the configuration: 

• The top level menu item list appears horizontally. 

• Subordinate menu item lists appear vertically, with the optional icon 

• There is an indication if a subordinate menu item is an "end action" or has fiirther 
subordinates 

• When an "end action" menu item is selected, its action is performed and all levels 
of the open menu object are closed. 

17. Menu objects float over all workspace panels and open pop-up displays. They are 
essentially non-modal, but clicking anywhere in the workspace other than on a menu 
item closes all levels of the menu. Thus, one active menu object can be open in the 
workspace at any time. 

1 8. Configurable menu actions include: 

• Launching displays, providing the most typical lunch context information 

• Launching a pop-up dialog, providing the most typical lunch context information 

• Perform typical display scaling operations on a specified panel, or "this" panel 

• Setting a display logic variable to a constant value 

• Running a display logic script 
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/. 7.2.5 ''Last Display *' Features 

A "go back to the last display" facility has traditionally proven valuable for operators. It 
provides an easy way to "recover" from a undesired display choice (e.g. mistake tjrping a 
display name or in choosing an unintended display link). 

When combined with a "go 'forward* to the display I 'last displayed' from", it provides an ad 
hoc means for an operator to assemble a small number of (potentially unrelated) displays into 
a (temporary) surveillance group. 

1.7.2.5.1 User Needs 

1 . The workspace will maintain a "last/forward display" stack for each framework fixed 
panel and each sub-panel in active sub-panel displays. (Floating panels do not have 
"last/forward display" stacks.) 

2. The display stack records enough information (display definition, launch information, 
scaling, scroll position, layers being displayed, tree expansions, etc.) about the 
workspace displays or workspace applications^"* when they are replaced by newer 
content, so that the previous display/application can be re-opened in a visual state 
that closely resembles it's state when it was replaced. 

3. The "last/forward display" stack for each panel will hold information for at least 10 
workspace displays or application instances. 

4. It will be possible to configure "Last Display" and/or "Forward Display" buttons in 
user configured displays. 

5. If a panel is configured to have an "information and tool button" bar, users may put 
"Last Display" and/or "Forward Display" button in that bar. 

6. To better support user configured toolbar displays, it will also be possible to configure 
a button in user configured displays to perform a "Last Display" for another panel, 
identified by panel name. 

7. Since the "last/forward display" stack is not infinite in size, there are situations where 
performing "Last Display" or "Forward Display" operations will have no effect. Each 
panel provides data sources for "can perform Last Display" and "can perform Forward 
Display" . Users may configure links in user configured displays to these data sources 
to alter the appearance of their "Last Display" and "Forward Display" buttons (e.g. 
hidden or subdued if they can't be used). The data links may be addressable for "this 
panel", and for a specific panel identified by name. 

8. Each time new panel contents are opened, the current content/state of the panel is 
captured as a "Last Display" in the "last/forward display" stack, before opening the 
new content. 

9. When a "Last Display" operation can be performed in a panel (there are "Last 
Displays" in the "last/forward display" stack), the operation captures the current 
content/state of the panel as a "Forward Display" in the stack, closes the current panel 
contents, and uses the most recent "Last Display" information from the stack to open 
that display or workspace application. 

10. When a "Forward Display" operation can be performed in a panel (there arc "Forward 
Displays" in the "last/forward display" stack), the operation captures the current 



Sufficient "last display" state information for workspace applications will probably be quite different for each 
application, and different than that for workspace displays. 
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content/state of the panel as a "Last Display" in the stack, closes the current panel 
contents, and uses the most recent "Forward Display" information from the stack to 
open that display or workspace application. 

1 1 . The individual "last/forward display" stacks for each sub-panel in a sub-panel display 
are not preserved when the sup-panel display is replaced. 

12. Saving a sub-panel display as a named instance does not save the individual 
"last/forward display" stacks for each sub-panel. 

13. The "last/forward display" stack is preserved with changes of DeltaV user log-on (fast 
user switching). The "last/forward display" stack is cleared if a "workspace hard 
reset" is performed or the workspace application is terminated. 

/. 7.2. 6 User Preferences and Presentation Persistence 

Providing operators more control over the combination and presentation of content displayed 
in the runtime workspace, raises the issue: "should display content/presentation settings be 
preserved for some level of reuse"? 

1.7.2.6.1 User Needs 

1. Unless being recalled via the "last/forward display" stack, panel displays appear with 
their "as configured" presentation settings (scale, view center, layers displayed, etc.). 

2. It will be possible to configure a "Save Panel View" button in user configured 
displays. 

3. If a panel is configured to have an "information and tool button" bar, users may put a 
"Save Panel View" button in that bar. 

4. To better support user configured toolbar displays, it will also be possible to configure 
a button in user configured displays to perform a "Save Panel View" for another 
panel, identified by panel name. 

5. When a "Save Panel View" action is performed, a standard workspace dialog appears 
(centered on the affected panel), providing a means for the user to enter a session- 
scope display name for the current content and view settings of the panel. A 
suggested display name, derived from the current panel content, with a suffix for 
uniqueness, should be offered. 

6. If the "Save Panel View" dialog is completed, the new display is created in temporary 
user-session display storage. For the remainder of that DeltaV user session (until the 
current DeltaV user logs off) the new display may be opened by the assigned name. 
When opened, the display initially appears with the same presentation settings (scale, 
view center, layers displayed, etc.) as it had when the "Save Panel View" action was 
performed. 

7. When a "Save Panel View" action is performed for a panel containing a sub-panel 
display, the current content and presentation settings for all sub-panels are included in 
the new display saved. 

8. Unless a "Save Panel View" action is performed to a new temporary user-session 
display, the presentation settings for a panel are lost once that display is pushed out of 
the "last/forward display" stack. 
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1.7.3 Using Displays 



1.73.1 Resolving Display Definitions 

Workspace display definitions hold the result of the display configuration process: a named 
collection of configurable properties and display components (with layout and presentation 
properties) along with associated display logic; sufficient to create an instance of a 
framework display, or pop-up dialog. 

For operational consistency, the same display definitions will usually be shared by 
(distributed to) many or all of the runtime workspaces ninning in a DeltaV system. To save 
display engineering effort, many display definitions will be designed to run adequately (and 
thus should be shared) by workspaces running with different sizes and types of display 
hardware. 

However, there are several situations where all workspaces sharing the same display 
definitions may not be desirable: 

• A display definition which has been changed should probably receive "live system 
testing" on a single workstation before being "released to production" and distributed 
to all workstations. However, the display that has been changed has many linkages 
(which should be tested) to other displays which have not changed (and are released 
for general use.) 

• A user may feel more comfortable using the English display definitions on his 
workstation, even though the primary language chosen for the DeltaV system when 
installed was non-English. 

• Some workstations in the system are being upgraded to new 16:9 monitors, and some 
of the most frequently used displays have versions optimized for workspace 
framework designed for this display hardware. 

• While troubleshooting a customer complaint, a technical support engineer wants to 
run the workspace using the pre-engineered displays that came with the DeltaV 
sofhvare^^, rather than the ones the user has modified. 

These needs suggest a solution where: 

• Its possible to have distinct display definitions with the "same" name used to open 
them. 

• Most instances of running workspaces in a DeltaV system want to use the "general 
use" display definitions. 

• Specific workspaces (doing display testing, running on unusual display hardware, 
being used by an atypical user) need a means to override the normal display definition 
resolution process with one specific to the purpose at hand. 

1.7.3.1.1 User Needs 

1 . It should be possible to configure a standard display definition resolution "search 
path" for each workspace framework. The search path establishes the sequence of 
locations searched to resolve a display definition name. For example, for a search 
path like: 

Released 



Suggests a need for a means to segregate the pre-engineered displays that came with DeltaV from the ones 
that users have built (even to replace the pre-engineered displays). 
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DvS t d\ Sy sLang\ 4 3Mon 

and assuming the workspace had been started with sufficient information to tell it that 
the root storage for all display definitions it should use was 

"C:\DeltaV\DVDATA\DDF", attempts to open a display with display definition name 
"AlarmBanner.ddf would look for it first in: 

c : \Del taV\DVDATA\DDF\Released\AlannBanner . dd£ 
and if not found there, would look for it in: 

c : \Dolt:aV\DVDATA\DDF\DvStd\SyoLang\43Mon\AlariiiBann©r . ddf 

In this case the pre-engineered displays that came with DeltaV would be used except 
for those that the user chose to override by putting them in the directory listed earlier 
in the search path. 

2 . It should be possible to alter the display definition search path for a workspace 
framework by providing additional information when the framework is launched. For 
example, assume the search path configuration for a firamework: 

Released/%Languago%/%DisplayHW%/%Skin% 

R©leas©d/%Languago%/%DisplayHW%/Default 

Relea0ed/%Language%/43Mon/%Skin% 

Released/%Language%/43Mon/Default: 

Released/ SysLang/%Di3playHW%/%Skin% 

Released/ SysIiang/%D±splayHW%/Dofault 

Released/SysIiang/43Mon/%Skin% 

Rel eased/ SysLang/ 4 3Moxi/De fault 

DeltaVStd/%Language%/%Di8playHW%/Default 

Delt:aVStd/%Language%/43Mon/De£ault 

Delt:aVStd/SysLang/%Dl8playHW%/De£ault 

Delt:aVStd/Sy8Lang/43Mon/De£ault 

and the workspace running on a 16:9 aspect ratio monitor, had been started with 
launch information including: 

DDP_PATHo"%DiaplayHW%o • 16 9Mon* 

After substitutions and eliminating paths with uiuresolved symbols, the effective 
search path for this workspace becomes: 

Released/SysLang/16 9Mon/De£ault 
Released/SysLang/43Mon/De fault 
DeltaVStd/SysLang/169Mon/De£ault 
DeltaVStd/Sy8Lang/43Mon/Def ault 

This essentially tells to workspace to look for display definitions in the 
/169Mon/Default directories first, and if displays optimized for the 16:9 monitors 
can't be found, use the old 4:3 aspect ratio displays. 

3. If should be possible to interactively view and alter the display definition search path. 
For example, with the search path configuration of the last example, a tech support 
engineer (more comfortable using English) starts an instance of the workspace with 
launch information including: 
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DDF_PATHa"%Language%e • BN* ■* 

After substitutions and eliminating paths with unresolved symbols, the effective 
search path for this workspace becomes: 

Released/BN/43Mon/Default: 
Released/Sy8Lang/43Mon/De£auIt 
DeltaVSt<i/EN/43Mon/De£ault 
DeltaVStd/Sy8liang/43Mon/Da£ault: 

He is getting the English displays when available, but he notices unexpected behavior 
in the alarm area filter display, and sees that the user has modified the standard one 
that came with DeltaV. He pushes the "Advanced Features" button in the TOOLBAR 
panel, which opens a user menu which gets him to a "Display Search List" menu item. 
He pushes it and a standard workspace dialog appears showing the current display 
resolution search list. 

He un-checks the list item for Doltavstd/SysLaiig/43Mon/0ef auit (since this was 
installed as a German system, he's not interested in the standard DeltaV German 
language displays). He then selects the list item for DoitaVStd/BN/43Mon/Dof ault, 
and moves it to the head of the list. Now he can test with the standard (English) 
DeltaV alarm displays on this workstation, until he gets this problem resolved. 

The "Display Search List" standard dialog supports: 

• Reordering the current search list 

• Adding new items to the search list (probably with browsing) 

• Disabling items in the search list (allowing them to be enabled again 
easily) 

4. Alterations made via the "Display Search List" dialog are maintained until that 
workspace instance closes, or a "workspace hard reset" is performed. After a 
workspace hard reset, the display definition search list is re-resolved per the current 
workspace framework configuration available, and the original launch information. 

5. It is expected that the display engineering application(s), will steer the user toward 
saving displays "under development" to a well known "Test" directory on the local 
workstation (a directory whose contents do not participate in the automatic display 
configuration distribution system.) 

When the display engineering applications go into display test mode, they run like a 
normal workspace, but the Test directory is added to the head of the display definition 
search list. Thus the displays in the Test directory can be tested, (with each other, and 
with displays already distributed in the "Released" directories) on that workstation, 
without impacting display behavior on the rest of the system. 

When the display engineer is satisfied that the display changes are sound, he 
(essentially) moves the displays from the Test directory to the appropriate Released 
directory, and (per the display distribution preferences configured) they are made 
available to all appropriate workstations in that DeltaV system. 
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1.7.3.2 Opening New Displays 

1 .7.3.2.1 Locations for New Displays 

By default, new display instances appear in the workspace at a location determined by 
matching the display definition (configuration) to the workspace configuration (and current 
content). However, a means to allow display logic to override the default workspace 
behavior is required. 

1.7,3.2.1,1 User Needs 

1. It will be possible to configure graphic elements (e.g. buttons) on displays and menu 
items to open new instances of displays in the workspace. 

2. It will be possible to open a display in a specified workspace panel (fixed or floating). 

3. It will be possible to override the default display location in the following ways: 

• Direct a display to "this panel" in the framework. 

a. If from a fixed or floating panel display, "this panel" is the panel the 
"from" display is already on. (The "from" display is replaced). 

b. If from a menu, "this panel" is the panel from where this menu (or one of 
it*s predecessor displays or menus) was opened. 

• Direct a display to a specific framework panel or anchor point by name. 

1 .7.3.2.2 New Display Scaling 

We expect users will create workspace frameworks that "nicely fit" their most frequently 
used display devices, and in turn will generally create display definitions that "nicely fit" their 
workspace framework (panel sizes and anchor point positions). The as-configured display 
definition size will be considered the "native" size for a display. We*d expect the user to 
choose a native size for a display that would require minor scaling adjustments for it*s 
primary intended use. 

Even with careful display engineering, minor scaling adjustments may often be required so 
that displays exactly fit the panels they should appear in (adjusting for minor changes in 
panel border widths, presence of information and tool button bars, etc.) For the most pleasing 
presentation (and avoidance of nuisance scroll bars) the workspace should automatically 
scale displays to exactly fit their destination panel, but not perform "extreme" scaling to fit. 

In addition, supporting simple overall scale adjustments to the "native size" of displays 
rendered could provide a means for a user to work effectively with a unusual screen 
resolutions, or with visual acuity issues. 

1.7.3.2.2.1 User Needs 

Display Layer Visibility and Scaling 

1 . It will be possible to configure layers in a display so they are not shown when the 
display is rendered below a specified scale factor (a value in the range of 10% to 
1000%) relative to the native size. 

Overall Scale Factor 
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2. It will be possible to apply an overall scale factor to displays that appear in the 
workspace. The overall scale factor (with separate factors for horizontal and vertical 
scale adjustments) is applied to the native size of displays (panel, and pop-up) as the 
first step in determining the final scaling of the new display to be rendered. Overall 
scale factors from 10% to 1000% will be supported. 

3. The overall scale (horizontal and vertical) factors is a configurable property for each 
workspace framework (defaults to 100% horz and 100% vert). The overall scale 
factors for a workspace can be overridden by launch information when the workspace 
application is started. 

4. It will be possible to change the overall scale factors for a workspace after it has 
started. It will be possible to configure a button in user defined displays or menu 
items to open the workspace "change overall scale factor" dialog. When a workspace 
hard reset is performed, the overall scale factors revert to those defined at workspace 
startup (launch info if present, otherwise as configured.) 

5. The "change overall scale factor" workspace dialog provide a means to see and alter 
the horizontal and vertical scale factors. When the changes are accepted, all currently 
open panel displays re-render themselves using the new overall scale factors in their 
scaling operations. 

Scale to Fit Panel 

6. After the overall scale factor is applied, additional scaling is automatically computed 
to cause displays to exactly fit the destination framework panel (ideally no scroll bars, 
and no gaps horizontally or vertically.) 

7. Extreme scaling is probably objectionable, so the workspace will apply "scale to fit 
panel" constraints: 

• Shrink limit: range: 10% to 100% (applies to both horizontal and vertical) 

• Grow limit: range: 100% to 1000% (applies to both horizontal and 
vertical) 

• Distortion limit: range: 0% to +/- 100% (acceptable change in the aspect 
ratio) 

If "scale to fit panel" scaling caimot be accomplished within the constraints, 
horizontal and vertical scaling within the constraints will be chosen, resulting with a 
display not filling the panel in either/both dimensions and/or scroll bars. 

8. The "scale to fit panel" constraints are configurable properties for each workspace 
framework. They can also be overridden by launch information when the workspace 
application is started. 

9. It will be possible to change the "scale to fit panel" constraints for a workspace after it 
has started. It will be possible to configure a button in user defined displays or menu 
items to open the workspace "change scale to fit panel constraints" dialog. When a 
workspace hard reset is performed, the constraints revert to those defined at 
workspace startup (launch info if present, otherwise as configured.) 

10. The " change scale to fit panel constraints " workspace dialog provide a means to see 
and alter the constraints. When the changes are accepted, all currently open panel 
displays re-render themselves using the new constraints in their scaling operations. 

Last/Forward Displays Scaling . 

11. Displays re-opened via the last/forward display stack for a panel do not have "overall" 
or "scale to fit panel" scaling applied. The actual scale (horizontal and vertical, 
including the result from any manual scaling operations that had been performed) 
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when the display was last deactivated is stored in flie last/forward display stack, so it 
can be again applied when the display is re-opened. 
12. The actual scaling information stored in the last/forward display stack is not affected 
by the "change overall scale factor" workspace dialog, or the "change scale to fit 
panel constraints" dialog. 

1.7.3.2.3 Opening Displays from other Displays 

One of the easiest (and most frequently used) means to open a new display instance is via 
another display already appearing in the workspace. Users will often use graphic elements 
(i.e. buttons) on displays specifically to provide easy access to related displays, or specialized 
display "directories". 

1,7.3.2.3,1 User Needs 

1 . I will be possible to use a button to open another display instance. Optional button 
configuration will: 

• Allow overriding the default location for the new display instance. 

• Resolve the name for certain "well known" displays (i.e. primary control, 
faceplate, detail) from a module name. 

• Provide a means for additional launch information so that tag resolution can be 
performed. 

2. I will be possible to click on a grouping of graphic elements (not necessarily a button) 
in a display and have the click action open another display instance. Optional 
configuration will: 

• Resolve the name for certain "well known" displays (i.e. primary control, 
faceplate, detail) from a module name. 

• Provide a means for additional launch information so that tag resolution can be 
performed. 

1.7.3.2.4 By Name 

Its quite possible that certain displays may not be easily accessible from other displays. A 
means to browse and select from all available displays (definitions) is necessary. 

1.7.3.2.4.1 User Needs 

1 . It will be possible to configure a button in user configurable displays to open the 
standard display selection dialog. 

2. In systems connected to other Delta V zones, the display selection dialog will allow 
the selection of another zone^^; defining the scope for display definition browsing and 
selection. The default zone selection is "this zone". If no other zones are available, 
zone selection does not appear. 

3. The display selection dialog provides the following types of display selection: 

• Standard displays: Display definitions in the selected zone that require no 
further "tag resolution". 



Constrained to zones which have been configured to expose their displays for use by this zone. 
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• Tag displays: Display definitions in the selected zone that require one or 
more tags to be defined, so that a display instance can be opened . 

• Session displays: Display definitions that have been created by (and private 
to) this instance of the runtime workspace application. 

• Recent selection displays: The last 20 standard or tag displays that have 
been selected by this dialog. (There is one "recent selection" history 
maintained in the runtime workspace^^.) 

4. When selecting standard or tag displays, the display definitions are shown using the 
current display resolution search path. Display definition names from all search paths 
are combined. By default^ display definitions not accessible due to search order are 
not shown. It will be possible to override the default, and have all display definitions 
shown (some distinguishable mainly by their "search path")* thus providing a means 
to override the normal search path in this instance.. 

If displays are organized by sub-folders, the sub- folder names also appear; allowing 
the user to drill-down into the display definitions stored in subfolder(s) with that 
name. 

Standard or tag display definition details may be shown (and sorted on) including: 

• display definition name 

• last modification timestamp 

• search path 

5. When selecting tag displays, it is possible to identify a specific tag display definition, 
and see the tag(s) that may be resolved. The tag(s) are identified by user-configurable 
comments (e.g. "Module name:"; intended to help the operator enter appropriate 
strings for tags to be resolved.) (The tag substitution strings entered will be included 
in the launch information when the tag display is opened.) 

6. When selecting session displays, details may be shown (and sorted on) including: 

• session display definition name 

• saved timestamp 

• saved by usemame 

7. When selecting session displays, a means to delete session display definitions 
(individual or multiple selection, or a "remove all" mechanism. 

8. When selecting recent selection displays, details may be shown (and sorted on) 
including: 

• display definition name 

• (if a tag display) tag string(s) 

• search path 

• last selection timestamp 

9. When selecting a tag display from the recent selection display list, it is possible to 
see the tag strings that were last used. The same tag strings can be used again, or they 
may be replaced. 



^® Used for faceplates, detail displays etc. where one (or a small number of lags) can be used to dynamically 
create a display instance "resolved" for the specific "target". 
The "recent display selection" history has nothing to do with the per-panel last/forward display stacks. 
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1 .7.3.2.5 From Controls and Workspace Applications 

Workspace application and certain workspace "controls" (which may be placed in user 
configured displays; e.g. an alarm summary control) may request that new displays be opened 
in the workspace ^. 

i. 7.3.3 Panning and Controlling Display Scaling 

Ideally, using displays designed for a workspace framework will eliminate the need for most 
manual display scaling or panning (using scroll bars) operations. Using displays in 
frameworks (devices) for which they weren't designed, will require some means to control 
scaling, and which parts of the display are currently visible. 

1.7.3.3.1 User Needs 

1. The following manual scaling operations will be accessible for displays in panels: 

• View All: all parts of the display are visible within the panel. Display occupies 
full panel area in one dimension and may have a gap in the other dimension 
(display distortion constraint still applies.) 

• Fill Panel: Display occupies full panel area in one dimension and may have a 
scroll bar in the other dimension (display distortion constraint still applies.) 

• Reset: Display is redrawn as if opened for the first time in the panel (Current 
"scale to fit panel" constraints are applied.) 

• Nudge Larger: current display scale (both horizontal and vertical) is increased 
by 10%. Will increase the scale until it reaches approximately 1000% of the 
native size. (Current aspect ratio is maintained) 

• Nudge Smaller: current display scale (both horizontal and vertical) is decreased 
by 9. 1%. Will decrease the scale until it reaches approximately 10% of the native 
size. (Current aspect ratio is maintained) 

• Native : display rendered at it's native size and aspect ratio; no overall scale 
factors or "scale to fit panel" constraints are used. 

• Set Display Scale dialog: causes a standard workspace dialog to appear, letting 
the user see and set the horizontal and vertical scaling factors for this display 
(overriding any "scale to fit panel" constraints.) 

• Region zoom-in: an operation where the user indicates a rectangular region in a 
framework panel, and the display scaling is increased and the display scrolled to 
center the view on the indicate region. (See details below.) 

2. It will be possible to create buttons in user configured displays for any of the panel 
scaling operations listed above. It will be possible to create buttons for any of the 
scaling operations in the information and tool button bars for workspace panels. It 
will be possible to perform any of the panel scaling options from a user configured 
menu item. 

It will be possible to configure the scaling operation buttons (or menu items) to direct 
the operation to "this" panel, or to another panel identified by name. 

3. Workspace panels show horizontal and/or vertical scroll bars, when there are parts of 
the display that are not currently visible in the panel. The scroll bars indicate the 
proportion of the display is currently visible in that dimension, as well as the current 



Since the workings of these actions are not (directly) user configurable (visible), the details are appropriate for 
design documents. 
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scroll position. Typical scrollbar clicking and dragging operations are used to move 
the visible portion of the display. 

4. It will be possible to perform a "region zoom-in'* operation, which combines a scale 
adjustment operation with panning, to show a close-up of an indicated area of a 
display in a framework panel. 

5. A "region zoom-in" operation requires several steps: 

• The operation is initiated via a button or menu item. The mouse pointer changes 
to indicate a region selection action is pending. 

• The user clicks in the framework panel to establish one comer of the region. The 
mouse pointer changes to indicate that a region selection action has been started. 

• The user clicks in the same framework panel to establish the opposite comer of 
the desired region. 

(When appropriate pointing hardware (mouse or stylus) is present, the last two steps 
can be combined by a pointer "drag" operation.) 

6. Once the desired rectangular region has been indicated, the display in that panel has 
it's scale adjusted so the entire rectangle will just fit (centered in) the panel area. 
(Scale to panel constraints are not applied, the current aspect ratio is maintained.) 

(Support special mouse operations for panning (e,g. drag panning mode)? Take advantage of 
2 and 3 button pointing devices? Useful mouse wheel behaviors?) 

1.7.3.4 Interactive Elements in Displays 

1 .7.3.4. 1 "Perform Action" Buttons 

Momentary "perform action" buttons are one of the simplest (and most obvious) interactive 
elements in user configured displays. 

1.7.3.4.1.1 UserNeeds 

Workspace Action Buttons 

1. It will be possible to configure "perform action" buttons in user configurable panel, or 
popup displays to perform workspace functions (many identified in previous 
sections.) Workspace actions include: 

• Close display 

• Copy this display 

• Paste display to panel 

• Snapshot panel contents 

• Launch detached window (from panel) 

• Show last display 

• Show forward display 

• Scaling operations: 



o 


View all 


o 


Fill Panel 


o 


Reset 


o 


Nudge Larger 


o 


Nudge Smaller 


o 


Native size 


o 


Region zoom- in 


o 


Show "overall scale factor" dialog 
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o Show "scale to fit panel constraints" dialog 
o Show "display scale" dialog 

• Save panel view 

• Switch workspace mode (dedicated vs. windows application) 

• Workspace hard reset 

• Show "display selection" dialog 

• Show "display search list" dialog 

• Show "display layers" dialog 

• Show "add display alert" dialog 

• Add alarm profiles 

2. Workspace "perform action" buttons are available in two standard sizes: small (match 
the appearance of workspace action buttons in information and tool bars for 
workspace panels), and large (larger versions of same). Standard size buttons are 
displayed with standard bitmaps corresponding to the workspace action they perform. 

3. It will be possible to configure custom size workspace "perform action" buttons; 
where the user choose the size/shape of the button rectangle. The user may choose a 
text legend to appear on these. 

4. By default, a standard (localized) tool tip string appears when the mouse pointer 
hovers over workspace "perform action" buttons. Users my change the string or 
disable the tool tip behavior for a button. 



Custom Action Buttons 

5. It will be possible to easily configure any of the following custom action buttons for 
use in displays: 

• Open Display: opens a new display instance for a specified display definition 
(panel, or pop-up); may optionally indicate a specified destination panel or anchor 
point. 

• Open Primary Control Display: opens a new display instance of the primary 
control display for a specified module; may optionally indicate a specified 
destination panel or anchor point. 

• Open Faceplate Display: opens a new display instance of the default faceplate 
display for a specified module; may optionally indicate a specified destination 
panel or anchor point. 

• Open Detail Display: opens a new display instance of the default "details" 
display for a specified module; may optionally indicate a specified destination 
panel or anchor point. 

• Open Application: opens the specified workspace application; may optionally 
direct the display to a specified destination panel or anchor point. 

• Open Menu: opens the specified user configured menu. 

• Open Operations Journal: opens the operations journal application, for the 
specified system object (module/node/device, etc.) 

• Write value: writes a configured (constant) string value to a workspace variable 
or to a real-time data source (i.e. DeltaV system); optional confirmation before 
write. 

• Increase value: writes a float value that is a specified x% of range larger than the 
current value read, constrained to the range; optional confirmation before write. 
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• Decrease value: writes a float value that is a specified x% of range smaller than 
the current value read, constrained tot the range; optional confirmation before 
write. 

6. It will be possible to configure the size of custom action buttons. 

7. It will be possible to configure a text label for custom action buttons. The text may be 
a constant string, or a reference to a workspace variable or real-time data source^'. 
The foreground and background colors are configurable; either constant colors, or 
determined by color information provided by the containing graphic element^^. 

8. A tool tip string can be configured to appear when the mouse pointer hovers over 
custom action buttons. 

1.7.3.4.2 Selection Targets 

Interating with displays by pointing at graphical elements can provide a powerful and 
efficient user interface for operators. The desired responses might inlcude: 

• Identification: the process control "tag" associated with the graphical element might 
appear briefly (like a tool tip), or appear in the "information and tool button" bar for 
the panel. 

• Setting "focus" so that workspace applications (or other workspace displays) designed 
to "track focus" can adjust their content automatically. (For example: a custom 
graphic schematic of DeltaV controllers arranged by their physical location in the 
plant; and the Diagnostics workspace application (in tracking mode) automatically 
showing the top level integrity information for each controller as it is selected.) 

• Exposing more information or UI controls: for displays cramped for space, less 
frequently used data links or "perform action" buttons might remain invisible until the 
graphic element they are associated with is selected. 

• Invisible buttons: the selection region for the graphic element can serve as an 
invisible perform action button used to navigate to another display or open a pop-up 
display with more data links and/or action buttons for the selected graphic element. 

1.7,3.4.2,1 User Needs 

1. It will be possible to configure "selection targets" in displays. The selection targets 
are defined as a rectangular region. 

2. Other configurable properties: 

• Selected data path: a string which provides the "data link path" to the object 
(module, node, DST, FF device, or (field of) parameter therein) that this 
selection target selects. If omitted, the selection targe has no actual selection 
behavior. . .it just behaves as in invisible button for the selection action. 

• Selection action: (optional) Selection targets may be configured to perform 
any of the workspace or custom action button functions listed previously. 

• Tool tip string (optional) When specified, appears when the mouse pointer 
hovers over the selection target. 

• Two step select for action: boolean property that controls the selectin 
behavior: 



" Button surface bitmaps or more elaborate animations would be possible combining our basic custom action 
button with other graphic elments. 

Expectation that color animation behavior would come from a "grouping** element. 
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o If TRUE: The action is performed if the selection target is selected again 
while already selected. (After the first selection, the selection target shows 
"is selected" focus, the workspace captures the "selected data path" in its 
variables, and the tool tip (if any is displayed). 

o If FALSE: The action is performed immediately upon (first) selection. 

Information provided when the workspace instance is launched can override 

this per-target configuration setting; forcing two step actions for all selection 

targets. 

3. At runtime, selection targets have two states: selected and not-selected. When a new 
display instance is created, all selection targets are not-selected^^. The current 
selection state is available as a workspace variable (associated with this target in this 
display)-*^. 

4. At most one selection target may be selected in a display instance. Selecting a new 
selection target (that has a "selected data path" configured) automatically de-selects 
any previously selected target in that display. (Each active display instance in the 
workspace my have it's own selection target in the selected state.) 

5. When a selection target (that has a "selected data path" configured) is selected, the 
workspace provides a visualization that it has "selection focus". The properties for 
the "selection focus" visualization are configured for the workspace framework, and 
include: 

• Selection region border line properties (style, weight, color) 

• Selection region rectangle fill properties (transparancy level, color) 

6. When a selection target (that has a "selected data path" configured) has a mouse 
pointer hovering over it, the workspace provides a "selection target present" 
visualization. The properties for the "selection target present" visualization are 
configured for the workspace framework, and include: 

• Selection region border line properties (style, weight, color) 

• Selection region rectangle fill properties (transparancy level, color) 

7. If the regions for selection targets overlap, the selection target "on top" at the selection 
point, receives the selection (or the mouse pointer hover behavior); the target(s) 
below do not perform any of their selection behaviors. 

8. If the region for a selection target overlaps with other interactive graphical element 
(perform action buttons, data entry controls, etc.) the object "on top" where the 
pointer selection is made gets the selection. Ordinarily selection target regions would 
be configured "below" other interactive graphical elements... so that clicking in the 
area but avoiding the buttons and data entry fields would "hit" the selection target. 

9. Selection targets which are currently invisible (or inactive) cannot be selected, nor 
produce the "selection target present" visualization. 

10. A well known workspace variable (instances for each panel and anchor point) holds 
the "selected data path" string for the currently selected selection target. The 



Unless display launch information includes information requesting an automatic selection be peformed. 
Expectation is that other graphical elements could have visiblity behavior tied to the selection state of a 
selection target. 
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"information and tool button" bar for the panels can be configured to have labels 
linked to these workspace variables. 
1 1 . A well known workspace variable (instances for each panel and anchor point) holds 
the "tool tip" string for the currently selected selection target. Other workspace 
applications (or displays) tracking the selection focus in this display can access the 
tool tip string to help describe their current tracking state. 

1 .7.3.4.3 Two State Data Entry Controls 

On/off type manipulations occur frequently in DeltaV control modules may also be used to 
interact with display logic for pop-up (dialog) displays. 

1.7.3,4,3.1 User Needs 

1. It will be possible to easily configure two-state data entry controls in displays. They 
provide a visual (one of two states) representation of the current value, and a means to 
change the current value. 

2. Choices for visual presentation include: 

• Button ("pushed in" indicates the "on" state). Button size is configurable. 

• S style checkbox (the indicates the "on" state) 

• 13 style checkbox (the "^"indicates the "on" state) 

• © style radio button (the "•" indicates the "on" state) 

3. Configuration includes: 

• Reference to workspace variable or real-time data source that holds the value that 
the control represents 

• (optional) The value that represents the "on" state. If not specified, all values 
other than the "ofT' value are displayed as the "on" state. 

• (optional) The value that represents the "off' state. If not specified, all values 
other than the "on" value are displayed as the "ofF* state*'^. 

• (optional) The value that should be written when the control is clicked (while in 
the "off* state) to turn it "on". If none supplied, it cannot be turned "on". 

• (optional) The value that should be written when the control is clicked (while in 
the "on" state) to turn it "off. If none supplied, it cannot be turned "off 

• If confirmation required before writing. 

• (optional) Tool tip string when in the "on" state. 

• (optional) Tool tip string when in the "off* state. 
Button style visual presentation configuration also includes: 

• Button label when in the "on" state. 

• Button label when in the "off state. 

4. Runtime response to clicking a two-state data entry control should be to give 
immediate feedback to the click action. (Changing the presentation between "on" and 
"off may be delayed (or even refused) if the control is connected to a DeltaV 
parameter.) 



Either the "on" or the "off* value may be specified. If the current value cannot be matched to either "on" or 
^•ofT" values when both are specified, the control becomes invisible and cannot be is turned off. 
" If neither "on" or -ofT' write values are configured, then the two state data entry control is "indicate only". 
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7,3.5 Numeric Data Entry Control 
Numeric data entry is frequently required in interactions with regulatory control modules. 



1,7.3.5.1,1 User Needs 

1 . It will be possible to easily configure numeric data entry controls in displays. They 
provide a visual representation of the current digital value, and a means to change it. 

2. Choices for visual presentation include: 

• *'In place" data entry: when selected, the control indicates selection focus and 
becomes a numeric data entry field (the current value is replaced by the empty 
data entry field and cursor). Keyboard numeric and Enter and Esc keys may be 
used to complete or cancel the data entry. 

• Numeric data entry dialog: when selected a standard workspace modal dialog 
appears providing numeric and Enter/Clr/Esc buttons^^. While the dialog appears 
the numeric data entry control continues to reflect the current value being read. 

3. Configuration includes: 

• Reference to workspace variable or real-time data source that holds the value that 
the control represents. 

• (optional) Reference to workspace variable or real-time data source that holds the 
maximum value that may be entered. No maximum value constraint if not 
configured. 

• (optional) Reference to workspace variable or real-time data source that holds the 
minimum value that may be entered. No minimum value constraint if not 
configured. 

• If confirmation required before writing. 

And if the numric data entry dialog form is chosen: 
• Dialog placement options 

i. 7.5. 6 Aiphanumeric Data Entry Control 

Alphanumeric data entry is sometimes used to communicate general information or 
commands to control systems. Often, the acceptable entries are limited, so selecting fi-om a 
list saves keyboard effort and avoids mistakes. 

1.7.3.6.1.1 UserNeeds 

1 . It will be possible to easily configure alphanumeric data entry controls in displays. 
They provide a visual representation of the current string value, and a means to 
change it 

2. Choices for visual presentation include: 

• "In place" data entry: when selected, the control indicates selection focus and 
becomes a alphanumeric data entry field (the current value is replaced by the 
empty data entry field and cursor). 

• Alphanumeric data entry dialog: when selected a standard workspace modal 
dialog appears. While the dialog appears the alphanumeric data entry control 
continues to reflect the current value being read. 



We may consider ofTering a means to switch to "four function calculator" mode in the numeric entry 
display... saving users having to pull out their calculator and rekeying in the results. 
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3. Configuration includes: 

• Reference to workspace variable or real-time data source that holds the value that 
the control represents. 

• If confirmation required before writing. 

And if the alphanumeric data entry dialog form is chosen: 
• Dialog placement options 

4. For either visual presentation, the control (or dialog) can optionally be configured to 
provide a selection list. When a selection list option is chosen, related configuration 
includes: 

• Reference to workspace variable or real-time data source that holds the values that 
should appear in the selection list. (A comma delimited string is expected.) 

• A "constrain entries to only selection list values" property. When false, entries 
other than those in the selection list (may be typed in) will be accepted. 

7. 7,3. 7 Specialized Display Components 

1 .7.3.7.1 Pop Up Dialog Displays 

1.7.3.7.2 Sub-Panel Displays 

1.7.3.7.3 Operator Prompt 

1.7.3.7.4 Alanfn Flood Management 

1.7.3.7.5 Display Tree 
1.8 Security Features 
1.8*1 User Authentication 

1.8.2 Fast User Switcliing 

1.8.3 User Privilege Aggregation 

1.8.4 Electronic Signatures 

1.8.5 Inter-zone Credentials Wallet 



424 



Process Display Configuration and 

Distribution 



425 



1. PROCESS DISPLAY CONFIGURATION AND DISTRIBUTION 428 

1 . 1 Related documents: 428 

1 .2 Objectives 428 

1 .3 Key Terms 429 

2. REQUIREMENTS 430 

2. 1 System Topologies - Single PC, DeltaV Style Systems, and Zones 430 

2.1.1 Single PC 430 

2,L2 Delta V Style Systems 4 30 

2,1.3 Zones 430 

2.2 Display Configuration 430 

2. 2. / General 430 

2. 2. 2 Look and Feel 432 

2.2.3 Static Elements 432 

2.2.4 Dynamic Elements 433 

2. 2. 5 Display Storage, 433 

2.3 Best Engineering Practices 433 

2. i, 1 Display Classes 433 

2. 3.2 Display References 434 

2.3.3 Bulk Edit 434 

2.4 Display Management 434 

2. 4. 1 Explorer 434 

2.4.2 vcAT. 435 

2.4.3 Download indicators 435 

2.5 Display Distribution 436 

2.5.1 Display assignment. 436 

2. 5. 2 Display downloading 436 

2.6 Runtime Structure and Behaviors 436 

2. 6. 1 Runtime Structure 43Q 

2. 6.2 Runtime Behavior, 437 

3. CONCEPT 438 

3.1 Overview 438 

3.2 Display Configuration 438 

3. 2. 1 Display Configuration Overview 438 

3.2.2 Display Constructs 43 Q 

3 .3 Best Practices - Display Classes 440 

J. 3. 1 Background , 440 

3.3.2 Display Classes 442 

3.3.2. 1 Process Cell - Display Class "SALTS" 442 

NOTE : there are actually 3 levels of view of a Totalizer in the examples 442 

• The one shown above called TOTALIZER-THUMBNAIL (no flow meter) 442 

• The one in REACTOR-DETAIL called TOTALIZER-OUTLINE 442 

• The totalizer detail display TOTALIZER-DETAIL 442 

3.3.2.2 Unit - Display Class "REACTOR-DETAIL" 443 

3.3.2.3 Display Class "TOTALIZER" 444 

3.3.2.4 Display Class "REACTOR_OUTLET" 445 

3.3.2.5 Display Class "LEVEL^METER" 446 

3.3.2.6 Display Class "ON_OFF_VALVE" ; 447 



426 



3.3.2.7 Display Class *TLOW_METER" 448 

3 .3.2.8 Summary of Display Class Relationships 449 

3. J. 3 Display Instances 450 

3.3.3.1 Download Bindings 450 

3.3.3.2 Instance Tree 451 

J. 3. 4 Display Class Downloads 451 

3.4 Display Management and Distribution 452 

3. 4. 1 Displays Folder and Sub-folders 452 

3. 4. 2 Operator Subsystem 452 

3. 4. 3 Download 452 

3.5 Interface with the Runtime 452 

J. 5. 7 Display Downloads 452 

3.5.1.1 Rich Client 453 

3.5.1.1.1 dynamic.dvg 453 

3.5.1.2 Thin Client 453 

3.5. 1 .2. 1 OpenDisplay.aspx & OpenDisplay.js 453 

3.5.1.2.2 FunctionBlocks.js 455 

3.5. 1 .2.3 dynamic.dvg.SVG/XMAL 455 

3.5.1.2.4 d3a1amic.dvg.js 456 

Figure 1. Display 'dynamic' 439 

Figure 2. Process Cell - Salts 440 

Figure 3. Display Class - "SALTS" 442 

Figure 4. Display Class - "REACTOR-DETAIL" 443 

Figure 5. Display Class ~ "TOTALIZER" 444 

Figure 6. Display Class - "REACTOR__OUTLET" 445 

Figure 7. Display Class - "LEVEL_METER" 446 

Figure 8. Display Class - "ON_OFF_VALVE" 447 

Figure 9. Display Class - "FLOW_METER" 448 

Figure 10. Display Class Relationships 449 

Figure 11. Display Storage 453 



427 



Process Display Configuration and Distribution 

This document describes Process Display Configuration and Distribution. It addresses the 
following topics: 



• Single PC, DeltaV Style Systems, and Zones - The Process Display implementation 
needs to support Single PC through multiple Zone topologies* 

• Display Configuration - look / feel, the configuration of static and dynamic graphic 
elements, and the integration with the overall configuration system (i.e. rename 
tracking, aliases, cross-referencing, etc). 

• Best engineering practices — part of this will be achieved through the use of Display 
Classes. Associating display classes with module classes allows displays and binding 
tables to be defined just once on a Module Class basis. 

• Display Management - manage displays as part of the configuration system. This 
includes display assignment for download purposes, download status indicators, and 
version control. 

• Display Distribution - allows displays to be moved fi-om the configuration system to 
target nodes. 

• Runtime Structure and Behaviors - a partial set of the runtime structure is 
summarized in this document. The requirements stated here are necessary to provide 
context for the overall configuration and distribution discussions. 



1.1 Related documents: 



Document: 


Controlled copy in Documentation 
Sou rceSafe: 


Technical Architecture 




Runtime Workspace 

























f.2 Objectives 

1- Fully integrated - Process Displays are fiilly integrated with the configuration and 
runtime subsystems. 

2- Ease of use - the Process Graphics System will be easy to use. Displays will be easy 
to call up on a wide variety of display devices. No display conversion is required to 
use displays on different devices. It will be easy to design displays for optimum 
usability on specific fomi factors. 

3- Support best engineering practices. The system will be designed to facilitate 
maximum re-use of displays and sub-displays through both standard and user-defined 



428 



libraries and through display classes, thus minimizing configuration and testing effort. 
[Points above are objectives from user 's standpoint, below are internal] 

4- The runtime will be separated from the configuration system. It will be developed 
independently (different engineering groups separated by lOOO's of miles). 

4- 

5- Separation of the graphics from the scripting engine. [For example, the graphics and it 
dynamics are defined in data (xml) that is interpreted by scripts (java)] 



1.3 Key Terms 




Framework panel 




Runtime workspace 




Workspace application 




Workspace display 




Workspace framework 
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2. Requirements 



2. 1 System Topologies - Single PC, DeltaV Style Systems, and Zones 

2.1.1 Single PC 

• Requirements from Simulate . . . 

2.1.2 OeltaV Style Systems 

• Requirements from single ACN System. . . 

2.1.3 2:ones 

• Requirements from a multiple ACN topology. . . 

2.2 Display Configuration 
2.2.1 General 

• Support control strategy and hardware renames (e.g. module, function block, 
parameter). 

• Support display reuse for duplicate/similar equipment. 

• Provide a mechanism for users to not be forced to send all displays to all 
workstations. 

• Displays are included in the database to allow system integrators to be able to switch 
databases on the same PC and have the displays switched as well. A total system 
download should switch out displays in the same way that control strategies are 
replaced. 

• Displays can be assigned to a general display directory. All displays at this level are 
downloaded to all workstations. 

May have display downloads, or are displays may be available through the (possibly 
redundant) display server. In this case the displays would just be uploaded (published) to the 
display server. The file locations within the display server would be immaterial since the 
display server would do its own file management ( as occurs in the prototype ). 



AD Containers 

^ DettdV/_System 
Ubrary 

^^--f^ System Conffguratton 

m' <Z> Recipes 

rfc- fS Setup 
I ^^4^ Control Strategtss 
I 1 Unassigned I/O References 

! 1 (Sl-Ss External Phases 
j ! (^i^ Dispteyra-e ctory 
j i I I hCxers I 

Displays can also be assigned to areas and follow Area, Unit, Equipment, and Module 
assignments (covered in more detail below). There are 2 primary reasons why users 
would move their displays out of the central display directory and into a display 
directory in the equipment hierarchy: 



Contents of ^^^i 



Name 


1 Type 


A PLMl 


PLM 




Modute 
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o Manage which displays are available (because of security) to which 
workstation. 

o Manage displays as part of the item in the equipment hierarchy. 
Users can drag a display to an area, cell, unit or equipment module. Doing so moves 
the display to the display directory subfolder under that item. Control modules do not 
have display folders. See below - 



AO Containers 




^ OeitaV.System 
3-f& Ubrary 

System ConRgurafcion 
'i ^)~<2> Redpas 
i ^I-^^ Setup 

Control Stratagias 
1 r'S^ Unasstgned I/O References 
] 1 External Phases 
■ Display Uractory 
' 1 £^ Mbcara 
1 > BoQarl 
1 4^^ALARM64 
I AREATA 


f 

■{ 


Name | Type 


Display 1 Display 
Display 2 oj^piay 
Display 3 Display 


i S-((^Dteplay Directory | 
1 I B-Q CLASS^ASEO 
1 i 1 &9ABases 

j 1 UNITW-CLASS 

j i \ ^"9 PLM-1 

1 ^ 1 PLMl 

! i S'-^LOOP 



o This display is now * owned* by that item. This means for example, that if the 
unit is deleted or exported (along with all sub-components), the displays are 
also deleted or exported. 
Displays can be shared as well as owned (similar to the concept we have of shared 
components of Module Classes). The same display might be associated with many 
items of equipment spread across several areas so you would not necessarily want any 
one item to own it. Display could be owned by an item higher up the hierarchy, or just 
owned by the library in this case. 

Displays and Display Classes can be associated with Module Classes, with references 
typically being relative so that they can be automatically resolved at run time or 
download generation time, requiring no manual input from the user. 
Another major benefit users have with assigning a display to the hierarchy is the 
•smart* things that can be done with ownership. Copy of a containing area, cell, unit, 
EM can perform a copy that allows the references to be automatically changed. For 
example, UNIT-1 contains 3 modules MOD-1, MOD-2, MOD-3 and DISPLAY 1, 
DISPLAY2. When UNIT-1 is copied, users have the option to provide the new 
names of the modules and displays, something like: 



Current Name 


New Name 


UNIT-1 


UNIT- 12 


MOD-1 


MOD- 12 


MOD-2 


MOD-22 


MOD-3 


MOD-32 


DISPLAY 1 


DISPLAY12 
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DISPLAY2 I DISPLAY22 
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o In doing this, all references to the 'current name' modules are replaced with 
the new names. Contained items are shown in the Current Name list. If a 
module or display had a reference to a module inside another unit, it would not 
show up here. 

o We could also include a mechanism to define 'instance specific' display 
components that could show up in the equivalent of 'Quick Configure*. For 
example, perhaps there is a text string that should be changed on each 
graphic.This is handled by the display parametisation. Any number of top 
level parameters can be defined for a display. Each parameter can control 
visual appearance and/or alias substitution within the display. 

• When displays assigned to a unit, area, etc., they will be downloaded to workstations 
that have that area assigned to either the alarms and events subsystem or the operator 
subsystem. This ensure that if a workstation is expected to get the alarms for an area, 
it has the displays for that area. 

• If a user wants displays to be sent to a workstation that does not have it's area 
assigned, then that area is added to the workstations operator subsystem. 

• A new 'Display Templates' directory is added to the library. Users can place displays 
in this directory. Copying a display out of the templates directory behaves the same a 
copying a module. Iliere are display templates which are essentially starting displays, 
sub-displays which are the equivalent to dynamos today and there are also libraries of 
display firagments which are just useful reusable bits of displays 

2.2.2 Look and Feel 

• Uncluttered editing area. 

• Frequent operations available without needing to call up menus. 

• Multi-level zoom. 

• All context operations available from right-click menu. 

• WYSIWYG text editing operations. 

• Multiple document interface. 

• Multiple windows can be open onto the same graphic. Any updates will be reflected 
in all windows. 

2.2.3 Static Elements 

• Supports current "best practice" in terms of graphic editing capability. 

• Fully support all standard primitive types (line, polyline, rectangle, circle, arc, image, 
text) 

• Support gradient fill for pseudo 3D look to tanks etc. 

• Support pipework with 3D look. 

• Provide very extensive set of edit functions for manipulating existing items. 

• In place editing of grouped objects without requiring ungroup. 

• Ability to "drill down" to edit any nested grouping level. 

• Ability to add attachment points to items, and then attach pipes or lines to these 
points. The pipe or line then tracks the item to which it is attached. 

• Complex graphic groups can be converted into images which can give better runtime 
performance. 

• User can choose any canvas size for a graphic. 
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• The user can define named libraries into which they can put arbitrary pieces of 
displays for later reuse. Each library item is given a name and can be given a 
description. 

2.2.4 Dynamic Elements 

• User interaction controls supported, text boxes, sliders, buttons etc. 

• Ability to animate a large number of item properties. 

• Ability to define user variables as part of a graphic primitive or grouping. 

• Variables can be private, for use within the algorithm of an animation. 

• Variables can be public and used to parameterize a dynamic algorithm. 

• Variables can be "deferred" , i.e. bound to another variable or a process value at an 
outer scope. 

• Item properties which can be animated can be bound to variables or directly to 
process values. 

• Binding to process values can use aliases, i.e. One or more portions of the process 
value path can be specified as being supplied by the value of a variable ( c.f. batch 
aliasing ). 

• Variables defined at the "top level" of a display can be used as parameters to the 
display. When the display is called up the caller can provide values for these 
parameters. 

• Use of variables and aliasing allows a display to be used as a Display Class. 

• Animation/scripting capability is provided by function block algorithms which can be 
attached to any item or group within the display. Function block algorithms read and 
write user variables. 

• Function block diagram editor evaluates the result of the algorithm with every change 
to the diagram, allowing the configurer to view parameters and values to debug the 
algorithm without needing to run the display. 

2.2.5 Display Storage 

• Process displays arc stored as part of the overall configuration model. Database 
support will be added to support 

o References to control items 

o Import/export 

o Versioning 

o Download checking 

o Online upgrades 

2.3 Engineering Practices 

2.3.1 Display Classes 

• Store Display Classes as static/dynamic elements and as a set of Display Parameters. 
The Display Parameters should be available for bulk edit. 

• Process Graphics will invoke the display passing the parameter values defined for the 
display instance. When invoked the display would be associated with a particular 
instance of the associated class based item in the equipment hierarchy. Most bindings 
would be relative to this but there may also be some absolute bindings. A display 
class simply has a top-level variable which acts as an alias for the module name. 
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When the display is called up the resolution for this alias is passed as parameter in the 
display URL. 

• Will download the Display and the Display Binding Table to Starbum Process 
Graphics. May upload to display server. 

• Changes to names will automatically be updated in the Display Binding Table and 
reflected in the download indicators. For bound names» this is similar to bound aliases 
in module classes. 

• Process Graphics will load the Display Class referenced in the Modules and lookup 
the correct bindings in the Display Parameter List 

• Process Graphics will allow for the definition of a Display Class as well as a thumb 
nail view of the Display Class. This will allow us to create a layered view (e.g. a Unit 
with Equipment - the equipment is shown as a thumb nail - when selected the 
equipment view opens up to full view). 

• Maintenance displays will be created. These Class-based Displays will be associated 
with Nodes, Cards, Devices, etc. 

• New conditioning monitoring displays will be created. These Class-based Displays 
will be associated with Condition Monitoring items such as Loop monitoring, Device 
Alerts, etc. 

2.3.2 Display References 

• Display item reference holders will be used to link display tags to system related 
items. 

• Any changes to items in the reference holders will cause the binding table(s) 
download indicators to trip. 

• Selecting * References. . . ' on a display shows any displays referencing the display, and 
any displays referenced by this display, along with all the data references from the 
display given the current alias values. 

• Selecting 'References. . . ' on a module show any displays referencing the module, in 
addition to other module references. 

• 

2.3.3 Bulk Edit 

• Bulk Edit of displays. . . 



2.4 Display Management 
2.4.1 Explorer 

• Process Graphics class-based display shortcuts are shown in Explorer in Display 
Folders (and sub-folders) under System Configuration. 

• Process Graphics non-class-based displays are also shown in Explorer in Display 
Folders (and sub-folders) under System Configuration. 

• Process Graphics pictures, either class-based or not, can be assigned to non-class- 
based modules. Currently Modules contain the following information: 

a. PRIMARY^CONTROL^DISPLAY 

b. INSTRUMENT_AREA_DISPLAY 

c. DETAIL DISPLAY 
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These properties will be left as is. 

In addition, a list of (Display Type, Display/Display Class) pairs will be added. 
This way we can generalize the application of e.g. thumbnails, outlines, detail 
displays, faceplates, maintenance displays, or whatever types make sense. This 
potentially facilitates the runtime selection of sub-display based on equipment 
mentioned later. 

• The Process Graphics display editor can be launched from Explorer. 
2,4.2 VCAT 

• A formal interface will be added to handle check in/checkout management tied to 
Process Graphics. If VCAT is enabled the check-in/check-out versions the displays. 

• A DBID will be assigned to Process Graphics displays. This allows users to get 
VCAT behavior. 

• Display Names may be unique across the system. This is because displays are copied 
into flattened directory structures. This is not necessarily true. Any display hierarchy 
could be supported if it was felt that it would add value. A flattened stnicture is 
certainly the simplest though. 



2.4.3 Download indicators 

• Manage download indicators on the Operator Subsystem and the Displays Folders. 
This includes the following: ( If we have a display server then most of this goes away 

) 

a. The Operator Subsystem on Workstations will be used to provide download 
indication (i.e. displays need to be downloaded). 

b. The Display Folder under System Configuration (similar to Recipes) will also 
be used to provide download indication. 

c. The download indicator for non-class-based displays is set on a system-wide 
basis. This means that when a non-class-based display is updated 

• The Operator Subsystem download indicator trips on all 
workstations. 

• The download indicator on the Display, Display Category, and 
Displays Folder trips under System Configuration. 

d. The download indicator for class-based displays is set on a system-wide basis. 
This means that when a class-based display is updated 

• The Operator Subsystem download indicator trips on all workstations 
where control modules reference the class-based display. 

• The download indicator on the Display, Display Category, and 
Display Folder trips under System. 

e. Update download status will regenerate the download indicator on displays by 
computing checksums on the displays. 
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2.5 Display Distribution 

2.5*1 Display assignment 

• Process Displays follow the Area assignments for Units, Equipment Modules, and 
Modules on workstations. 

• Process Displays are downloaded to the workstations where they are defined. User 
should be allowed to control exactly which graphics get downloaded to a workstation. 

• Process Displays may follow security. 

2.5.2 Display downloading 

• Context menu of Operator Subsystem includes Download All displays. Download 
New and Changed Displays. 

• Allow users to download all displays from the Displays Folder. This is consistent 
with a total system download. 

• Allow users to download one Display Folder at a time. This is consistent with Recipe 
Procedure/Unit Procedure/Operation downloads. Note all nodes where the displays 
are assigned will be downloaded. 

• Context menu of a display in the library includes Download and the user can elect to 
download the display to all workstations to which it applies (which might be all or a 
subset of the workstations in the system depending on the answer to the earlier 
question). 

• Foreign documents can be associated with both Class-based and non-Class-based 
displays. This allows the Process Engineers to provide operating instructions 
associated with Displays that Operators can use to assist in using the item the display 
is associated with. (Note, if we are going to associate foreign documents with 
displays, then we should also associate foreign documents with composite templates, 
module templates/classes so that users can link their custom help information to these 
objects). 



2.6 Runtime Structure and Betiavlors 

2.6.1 Runtime Structure 

• Supports execution in internet explorer. 

• Clean separation of display framework from display specifics. 

• Graphics defined in SVG file, one per display 

• Dynamics defined in JavaScript file, one per display 

• Library of support JavaScript is in a single file which can be cached by the client. 

• Library of function blocks is in a single file which can be cached by the client. 

• Display is invoked through an ASPX page which pulls together the support 
JavaScript, the function block JavaScript, the display specific SVG file and the 
display specific JavaScript file. 

• The display server and the data server can be separate servers or combined into a 
single server. 
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2.6.2 Runtime Behavior 

• Graphic can be run by a C# client application or in an internet explorer on any 
supported platform. 

• The internet explorer client windows have no menus or toolbars so that the display 
application can control navigation and other features of the window. 

• C# client uses Web methods to communicate with the data server. 

• Internet explorer client uses http post to communicate with the data server. 

• Process value bindings can be changed while a display is running, for example by the 
user changing the value of an alias. This will cause a re-registration with the data 
server to obtain the new data set. 

• One graphic can call another. The calling graphic can dynamically control which 
display is called up, and the values of any parameters passed to the called display. 
This enables a Display Class to be invoked on a specific module for example. 

• If connection from a graphic to the data server for the display is lost, the connection is 
automatically re-established when the data server becomes available again. 

• The graphic can have independent update periods for running animations and for 
getting data from the data server. 

• Function blocks provide a secure mechanism for defining dynamic behavior which 
can be readily implemented in both a C# and internet explorer display client. 
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3. Concept 



3.1 Overview 

Display management will be very different in Starbum. Unlike Delta V where Process 
Displays are edited and managed external to the configuration system, in this system the user 
always edits the database copy and saves the display directly to the database. In addition, 
unlike DeltaV where displays are moved around using Yellow-Pages, in displays are 
downloaded out of the configuration system just as control strategies are. This allows 
displays to be managed via download indicators and versioned along side their control 
counterparts. 

3.2 Display Configuration 

3.2.1 Display Configuration Overview 

The graphics system needs to be able to support many constructs including 

• save/restore 

• downloading 

• animation 

• real-time data 

• parameter substitution (e.g. faceplates and class-based behavior) 

• graphic element grouping 

• behaviors 

• running the display in a Rich or Thin Client 

• etc 

To illustrate these concepts display 'dynamic' has been created. This display is shown 
below. 
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Figure 1. Display 'dynamic' 



3.2.2 Display Constructs 
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3.3 Display Classes 

This scenario also inherently covers bulk edit, aliases, and referencing. 



3.3.1 Background 

This scenario is intended to illustrate the principles of the use of Display Classes. The 
standard parameter names used are suggestions and subject to review. The plant equipment 
is shown in the drawing below. 




Figure 2. Process Cell - Salts 



A plant has a number of reactor units of similar design. In this example there are three units 
in the process cell named "SALTS". 

Each unit mixes a specified quantity of acid, alkali and water to produce a product. Each 
reactor has a private feed of acid and alkali but all units share a single water header. Each 
reactor has an outlet that goes to the product tank or to drain. 
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In Explorer the configured module classes would appear as: 



Library 



Advanced Definilions 



Control Module Classes 
General 



+ON_OFF VALVE 
+FLOW METER 
+LEVEL METER 



Equipment Module Classes 
General 



TOTALIZER 



Command-driven 



+COARSE_VALVE ON OFF_VALVE 
+FINE VALVE ON_OFF_ VALVE 
+FLOW_METER FLOW_METER 
+RUN_LOGIC 

+COMMAND_2 Totalize^Accurate 
+COMMAND_3 Totalizc^Fasi 
+COMMAND_99 Reset 
+STOP_LOGIC etc. 
REACTOR OUTLET State-driven 

+bUTLET ON^OFF VALVE 

+DRAIN ON.OFF" VALVE 

+PRODUCT ON^OFF VALVE 

+RUN LOGIC 
+STOP_LOGICctc. 



Unit Classes 



General 



REACTOR 



DOSE 

MIX 

DRAIN 

FLUSH 

+AC1D 

+ALICALI 

->WATER 

+WATER IN 

+LEVEL_METER 

+OUTLET 



Phase 
Phase 
Phase 
Phase 

TOTALIZER 

TOTALIZER 

TOTALIZER 

ON_OFF_VALVE 

LEVEL_METER 

REACTOR_OUTLET 
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3.3.2 Display Classes 

Display Classes are used to make the configuration of displays easier to manage and easier to 
do. Displays are populated with sub-displays based on a users "Component Level Menu" 
selection. 

3.3.2, 1 Process Cell - Display Class ''SAL TS'' 

A plant has a number of reactor units of similar design. There are three units named 
"REACTORl". "REACTOR2", and "REACTORS" in process cell "SALTS". 



Totsb V OmSm - BIndine t 




- }^ 


K 


^ A 


- A 


Rm 
Un 

Alkaa 


Lavtl 


Rvactcr 

unt OuMPredua 


^ OuM Product 
MMB - J 


Oram 

f 

RaetarOueiM • Bindi« 2 
-REACTORr 


J 

RmOw OuttM . BMno a 
•REACTORr 


f 

Ructtr CMHn* . BMno « 
-REACTOR3* 



Figure 3. Display Class - ''SALTS'' 
The binding table for the Process Cell Display Class is summarized below: 



mi 










1. 


TOTALIZER-THUMBNAIL 








2. 


REACTOR-OUTLINE 








3, 


REACTOR-OUTLINE 








4. 


REACTOR-OUTLINE 









NOTE : there are actually 3 levels of view of a Totalizer in the examples 



• The one shown above called TOTALIZER-THUMBNAIL (no flow meter). 

• The one in REACTOR-DETAIL called TOTALIZER-OUTLINE, 

• The totalizer detail display TOTALIZER-DETAIL, 
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3.3.2.2 Unit - Display Class "REACTOR-DETAIL" 

The following drawing shows the subdisplays for the Unit Display Class "REACTOR- 
DETAIL". 



Subdisplay TOTALIZER - Binding 1 
•/WATER- 



Subdisplay ON^OFF VALVE - Binding 2 
-WATER IN- 



Subdisplay TOTALIZER - Binding 3 
VACID' 



n — 



— E1|g 



Subdisplay TOTALIZER - Binding 4 
-/ALKALI- 



/ \ 



Reactor 
Unit 



Subdisplay LEVEL IMETER • Binding 6 
•/LEVEL_METER- 




SubdiSplay REACTOR_OUTLET . Binding 5 
-/R6ACTOR_OUTLET- 



Figure 4. Display Class - ** REACTOR-DETAIL" 

The binding table is summarized below: 







MUSI"., 




1. 


AA^ATER 






2. 


/WATERJN 






3. 


/ACID 






4. 


/ALKALI 






5. 


/REACTOR^OUTLET 






6. 


/LEVEL^METER 






7. 


STATE.CV 






8. 


/#WATEFWSTATE.CV 
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3.3.2.3 Display Ciass ''TOTALIZER'' 

The TOTALIZER consists of three control elements, a coarse valve, a fine valve, and a 
meter. These work together to provide a totalizing input capability. From the totalizer 
display the user can navigate to ON_OFF_VALVE's and FLOW METER. 



Subdisplay ON.OFF VALVE - Binding 1 
"/COARSE_VALVE- 






Subdisplay FLOW METER - Binding 3 
•/FLOVV.METER- 






e 




Subdisplay ON OFF VALVE • Binding 2 
•/FINE.VALVE' 









Figure 5. Display Class - "TOTALIZER" 



The binding table for the Display Class is summarized below: 









1. 


/COARSE_VALVE 




2. 


/FINE^VALVE 




3. 


/FLOW_METER 
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3.3.2.4 Display Class **REACTORjOllTLET** 

The reactor outlet contains three valves which coordinate the transfer of reacted material to 
drain or to product. From the REACTOR_OUTLET display the user can navigate to 
ON OFF VALVE'S. 



Subdisplay ON.OFF VALVE - Binding 1 
VOUT1.ET_VALVE" 




Subdisplay ON OFF VALVE - Binding 3 
•/PRODUCf_VALVE" 









Subdisplay ON_OPF_VALVE - Binding 2 

•/drainJvalve" 



Figure 6. Display Class - "REACTOR_OUTLET- 



The binding table for the Display Class is summarized below: 











1. 


/OUTLET_VALVE 






2. 


/DRAIN_VALVE 






3. 


/PRODUCT.VALVE 
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3.3.2.5 Display Class "LEVEL^METER" 

The LEVEL_METER is a detailed display. There are no further linkages to other displays. 




Figure 7. Display Class - "LEVEL_METER 



The binding table for the Display Class is summarized below: 











1. 


/AI/OUT 






2. 


/DRAIN.VALVE 






3. 


/PRODUCT.VALVE 
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3.3.2. 6 Display Class "ON_OFF_ VAL VE'' 

The ON_OFF_VALVE is a detailed display. There are no further linkages to other displays. 



value tied to • Binding 1 




Value tied to > Binding 2 
-CURRENT.STATE.CV 



Figure 8. Display Class - "ON.OFF.VALVE" 



The binding table for the Display Class is summarized below: 













1. 


TARGET^STATE.CV 








2. 


CURRENT_STATE.CV 
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33.2,7 Display Class ''FLOfV^METER'' 

The FLOW_METER is a detailed display. There are no ftirther linkages to other displays. 



Value Tied to - Binding 1 
"INT_OUT.CV 



Value Tied to • Binding 2 
•INT_iRESET.CV" 



Figure 9. Display Class - "FLOW.METER" 



The binding table for the Display Class is summarized below: 
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3. 3. 2. 8 Summary of Display Class Relationships 

The following drawing illustrates the mapping between displays. Some of the displays, such 
as "TOTALIZER", will have more than one level of detail. In the case of TOTALIZER we 
have "TOTALIZER-THUMBNAIL", "TOTALIZER-OUTLINE", and "TOTALIZER- 
DETAIL". 
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3.3.3 Display Instances 
3.3.3. 1 Download Bindings 

The following summarizes what the user would see in the Library hierarchy. 

NOTE : We would not see instance information here. The display class would have 
short-cuts to sub-display classes used. This is information that we would extract from 
the display and store as references so we know the dependencies. A top level library 
category for display classes will be added along with sub-categories for organizing. 
Short-cuts have been shown with ->. 



Library 

Display Classes 

Unit Displays 

REACTOR DETAIL 

->TOrALIZER OUTLINE 
->REACTOR dUTLET_OUTLINE 
->ON_OFF_VA LVE_OUTLlNE 
->LEVEL„METER_OUTLINE 

Equipment Module Displays 
TOTALIZER 

->ON_OFF_VALVE_OUTLINE 
->FLOW_METER_OUTLINE 

REACTOR OUTLET 

3ON_OFF_VALVE_0UTLINE 



Control Module Displays 

FLO W_M ETER^DETA IL 
FLOW_METER_OUTLINE 
LEVEL_METER_DETA IL 
LEVEL_METER_OUTLINE 
ON OFF_VALVE DETAIL 
0N"0FF valve OUTLINE 
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3.3*3.2 Instance Tree 

The following summarizes what user would see in the Control Strategies hierarchy. 



Process Cell "SALTS" 

CBCM "WATER" 

CBCM'^COARSE VALVE_I" 

CBCM **FlNE_VALVE_r' 

CBCM "FLOW_METER r 
CB UNIT "REACTOR I" 

Shortcut to "WATER" 

CBEM "ACID^l" 

CBCM XOARSE_VALVE_l T 
CBCM "FINE_VALVE 1 1"" 
CBCM -FLOW_METER I I" 

CBEM "ALKALI I" 

CBCM~"COARSE VALVE_I_2" 
CBCM "FINELY AlvE^I^r' 
CBCM "FLOW_METER_l_2" 

CBEM "REACTOR OUTLET r 

CBCM "6uTLET_VALVE_r' 
CBCM "DRAIN VALVE_l" 
CBCM "PRODUCT_METER r 

CBCM "WATER IN_r 

CBCM "LEVEL_METER_I" 
CB UNIT "REACTOR I" 

CB UNIT "REACTOR 1" 



3.3.4 Display Class Downloads 

The display system will hold the following: 

• A list of items in equipment hierarchy, each having a list of (Display Type and 
Display/Display Class) pairs. 

• A display having 

o A binding list which is simply a list of paths, which may be absolute or 
relative to the current equipment item. 

o A display in which 

■ Sub-display elements are either statically bound to Displays/Display 
Classes or are bound to a Display T3rpe which will be used to 
determine the actual display from the bound equipment item. 

■ All dynamic elements, including sub-displays, are cross referenced to 
an entry in the binding table. 
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3.4 Display Management and Distribution 

3.4.1 Displays Folder and Sub-folders 

A Displays Folders will be added to the Explorer under System Configuration. The Displays 
Folder will support Display Categories. Users can arrange their Class-based as well as their 
non-Class-based displays in the displays folders. 

3.4.2 Operator Subsystem 

The Operator Subsystem under workstations will be used to indicate whether or not displays 
require downloading. When set it indicates that displays need to be downloaded. 

3.4.3 Download 

There are two locations to download displays from. The most general is the Operator 
Subsystem on Workstations. When the user downloads from here all they know is that all 
displays, including display classes, will be downloaded. The second location to download 
displays from is the Displays Folder under System configuration. 

When Users download displays from the 'Displays Folder* all workstations in the system are 
downloaded. The User may also select the Displays Subfolder. When they download from 
here all of the workstations where displays hold associations will be downloaded. The user 
may also drop down to specific displays and download them one at a time. When they do 
this all workstations where the display holds an association will be downloaded. 

3.5 Interface with the Runtime 
3.5.1 Display Downloads 

Supporting both Rich (Win Forms) and Thin Clients (IE, Handhelds, Smart Phones) requires 
the cooperation of several techniques. Rich Clients can directly load the native SVG format. 
Thin Clients make use of a combination of SGV and Java scripting. To illustrate these ideas 
Process Display ^DYNAMIC is used below. Associated with Process Display 'DYNAMIC 
are the following files: 



dynamic.SVG/XMAL 


The Rich Client files will be in XML format. 


OpenDisplay.aspx 


Initial HTML file - used to select display to be 
displayed. 


OpenDisplay.js 


Works with OpenDisplay.aspx to open initial display. 


FunctionBl ocks j s 


Provides display element dynamic behavior. 


dynamic.dvg.SVG/XMAL 


SVG/XMAL format of dynamic.SVG/XMAL file. 


dynamic.dvgjs 


Provides dynamic [i.e. scripting] behavior for display 
•dynamic.SVG/XMAL' 



The relationship of the files is illustrated and discussed below. 
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Configuration 




Tools 


(E.g. u» 


er editing display 'dynamic') 




Rich CUonl Thin CUent 

RIes Files 




Figure 11. Display Storage 



3.5.1.1 Rich Client 
3.5.1 .1 . 1 dynamic.dvg 

The file 'dynamic.dvg* contains the complete data storage for the display. Both the editor 
and the rich client for runtime access this file. 

3.5.1.2 Thin Client 

3.5. 1 .2. 1 OpenDlspIay.aspx & OpenDisplay.js 

The file 'OpenDisplay.aspx* is used to open the thin client display. The file provides several 
functions: 

opens the display requested by the user 

using *OpenDisplay.js* identilys all of the dynamic fields and registers for updates 

handles dynamic updates 

sets up the default data entiy dialog 

handles user entered data 



This file 'OpenDisplay.aspx' is listed below: 

<%@ Page languagc="c»" Codebehind»"OpenDisplay.aspx.cs*' AutoEventWireupsTalse" lnherits^"WebUi.OpenOisplay" %> 
<!DOCTYPE HTML PUBLIC V/W3C//DTD HTI^L 4.0 Transitional//EN" > 



<HTML> 

<HEAD> 

<TrrLEx/nTLE> 
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<META NAME^XjENERATOR" Conient»''MicrosoA Visual Studio 7.0*> 
^ript language»**javascnpr src=''<%jsNameO; %>"X/script> 
<script languages^javascripf* src»"OpenDisplay.js*'X/8cripf> 
<script language^'ljavascript'* src="FunciionBloclcs.js*'^script> 

</HEAI» 

<BODY onload="initPagcO;" onunload^-dcregistcrForPagcUpdaicsO" style^'-MAROrN: Opx"> 

<EMBED id^-id.Graphic- src="<% displayNamcO: %>" iypc=-imagc/SVG/XMAL-»-xmr height»*800* 
width='*600'' plugiiispage»'1ittp;//www.adobexom/SVG/XMAUviewer/iiutall/'></^ 
<p id="id_resyncCount"x/p> 
<p id=»''id_nClient'*x/p> 
<fonn> 

<pxlNPUT id-"resei" typc""button" onClic1cB''remoteActionCResetO;'* vaIueo''Rcsci Server" 

name""rcsct'X/p> 

</form> 

<div id="id_emerVa!ueDiv" style^^display: none**> 

<iframe id="id__emerValucFrame" src="EnierValue.htm" style="position: absoJute; top: 100; left: 100; 
height: 90; width: 350; background-color: #999999 ; border Ipx solid black** bon!et«"0*X/irrame> 
</div> 

</BODY> 

</HTML> 

The file *OpenDi splay js' contains many pre-built functions. These functions scan the 
*SVG/XMAL' file identifying parameters that need to register for dynamic updates, handle 
dynamic updates, handle user entered values, etc. A small part of this file is listed below. 

// 

// Constructor for object holding dynamic element information 

// 

runctton DynamicElement( node , script , nodeAttribute » valueConditioning , tag ) 

this.nodc = node ; 
this.nodeAttribute = nodeAttribute ; 
this.valueConditioning = valueConditioning ; 
this.tag =^ tag ; 
this.script - script ; 

) 

II 

// Function to capture the SVG/XMALDocumcnt to that we can manipulate it from 
// our script 

n 

function loadSVG/XMAL( evt ) 
{ 

var SVG/XMALDoc = evt.getTaigetO.getOwncrDocumcntO ; 

vor SVG/XMAL = SVG/XMALDoc.getElementById( "id_SVG/XMAL" ); 

var embed = documenLgetE]emeniByld(*id_Oraphic*0; 
embed.setAttTibuie( "Vidih" . SVG/XMAL.getAttribute('*width") ); 
embed.setAttribute( "height" » SVC/XMAL.getAttribute("height**> ); 

SVG/XMALDocument=SVC/XMALDoc ; 

} 

// 

// Gets die list of tags which are referenced in the SVG/XMAL document 
// Keeps a list of dynamic element objects which should be updated 

// 

function getListOfTagRequestsQ 
( 

Uglndices new ArrayQ ; 

} 

// 

// Prompts the user to enter a new value for a Uis 

// z 

function cnterValue( tag , x . y ) 
( 

// Move to just below the entry field 

id_enterValueFrame. window, frame Element.styleJell » x ; 
id_enterValueFrame. window. frameElement.style.top « y+30 ; 
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3.5.1.2.2 FunctionBlocks.js 

The file 'FunctionBlocks.js' is used to support the addition of scripting behavior. Scripting 
behavior allows the user to perform additional data manipulations such as scaling a 
parameter, manipulating parameters, performing logic and taking action based on the logic, 
etc^. A small part of the file is listed below: 

function ADD4( index » DMl , [N2 , IN3 , IN4 ) 
{ 

lhisrADD4.0UTJ*+indcx] = -(-INI - IN2 - IN3 • IN4) ; 

} 

function D1V( index , IN . DVR ) 

{ 

thisfDIV OUT_"+index] = IN/DVR ; 

\ 

function SEL ( index , IN , VT , VF ) 
t 

tf(IN!»0) 
{ 

thisfSEL_OUT_"+index] = VT ; 

} 

else 
I 

this["SEL,OUT "+indcx) = VF ; 

) 

> 

function RD ( index » tag ) 
{ 

this("RD_"+indexl = va]ueOa[ tag ); 

) 

function WD ( index » tag , value ) 
{ 

updateValue( tag . value ); 

) 



3.5.1.2.3 dynamic.dvg.SVG/XMAL 

The file *dynamic.dvg.SVG/XMAL* is the SVG/XMAL version of the file *dynamic.dvg\ 
Dynamic data behaviors have been factored out into java scripts. 

<?xml vcrsion=**1.0'' cncoding=»''utf-8*' standalone=''ycs"?> 

<SVO/XMAL xmlns:dvs'*abcderg'' id=="id_SVG/XMAL- width-' 1024- height="768" onloads''!oadSVG/XMAL(evt);"> 
<g dv:type="canvas" dv:update-pcriod="100'*> 
<reci widih="l 024" hcight="768'' rin==^"#ebebeb" /> 
<g dv:lype="none'> 

<rect x="2" y="2" widths" 1 020" hcight="764'* fiIN*none" stroke="#0OO0OO" stroke-width-" I " /> 
</$> 
</g> 

<g> 

<rcct x="250" y«"35* widlh="l 75" height=-30" fill="#d3d3d3" onclick="enterValueC_MODULE r,250,35);'' 
onmouseover«'*eventMouseOver(evt)'* onmouseout="eventMouseOut(evt)" /> " 

<icxt x="250" y=**54** nil»**#000000'* ront-family»*'Arial*' font.size=s"lOpr text-anchor="start" 
onclick«='*enterVaIuer_MODULE. r,250,35);- onmouseover»''eventMouseOveKevt)'* 

onmouseout=:**evemMouseOut(evt)'*>MLMOD<dv:dynamtc5 id="id DYNAMICO" tag="'_MODULE 1'" attribute-^text** A></text> 
<rect x="10- y=-35" width="235" height="30" fin="#d3d3d3- 

<text x="245" y="54" 011= "#0000 00" font- family- -Aria r font-sizc«"lOpt" text-anchor="end">ModuIe:</text> 
<rcct x«"IO" y«"80" width="235'' hcight="25" rill='Wd3d3d3" /i» 

<texl x«*'245" y^^Ve** fill="#O0O000" ront-family='''Ariar' font-size=-10pl" text-anchoi="end">//MLMOD/OUT.CV<dv:dynamics 
id=»"id_DYNAMICI " iag='"*+_MODULE_l+yourCV- attribute="text" valucConditioning="val="+ MODULE 1+VOUT.CV" 
/x/iexK> 



' These behaviors were supported in iFIX using VBScripting and in FIX using custom FIX logic. Rich clients 
can directly execute the behaviors. Thin Clients get exactly the same behavior support using Java scripting. 
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<rectx-'^5O"y-"80*'widlh="175"height-'75" nn«'VW3d3d3-/5> , a -- a ^^^n^AKAin'y^ 

<tcxx x«"250" y="96" fill="#0000O0" font-iainily="Ariar font-si2e=*'lOpt*tcxi-anchor=-start">0,00<dv:dynamics id= id_DYNAMlcz 

iag=""+ MODULE 1 +VOUT.CV* anribuie^^lext** valucCondiiioning=-val=fmt(val»2)* /X/iexi> 

<recix='750-y=-Tl5-width='90-heighl=*75"mi=*^3d3d3"stroke-widih«^^^ w.«««x« 
<dv:dynamics id="id_DYNAMIC3"tag='^+_MODULE_l+'/GAIN.CV" attribute- Vidth" vaIueConditioning= val=(90»val/100.0) 

/> 

<g> 

<dv:dynamics id»*id_DYNAMIC7" script="dynamic_7(SVG/XMALComcxl);" /> 
<rect x-'HO" y="355' widih='^5" hcighi='7S" rill="#d3d3d3"oncIick=-cmcrValucCINl_4M40,355);" 
oninouseovcr='"eventMouseOver(cvt)* onmouseout^-eveniMouseOutCevt)" f> 



3.5.1,2.4 dynamic. dvg.js 
The file •dynamic. dvg.js' 

function dynamic 7(SVG/XMALContext) 
{ 

RCKO; IN1_4'); 

RD(2;_rN3,5*); 
RD(3;_IN4_3'); 

ADD4(4.RD__0.RD_1 ,RD_2,RD_3); 
WD(5.' OUT 8'.ADI>4„OUT_4): 
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Display Logic and Language 
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1 , _Starburn D Dispiay Logic and Language Concept 

This document describes the concept for display logic and language support as it pertains to 
the runtime operator's workspace within the Starbum development program. Its goal is to 
identify user needs in this area, and to define concepts for a collection of system features that 
would meet those needs. Toward that end, this concept document defines the primary 
methods and means by which operational displays and the objects contained within them can 
be manipulated and linked together in order support dynamic, animated behaviors. 



1.1 Objectives 

The primary objective for the Starbum display logic and language feature set is to provide 
end users the capability to configure and engineer operator displays and display components 
which dynamically interact with the underlying control system (including runtime data, 
historical information, field devices, etc. . .). In the majority of cases, this configuration effort 
should require little to no programming effort, but the environment may maintain the ability 
to customize pre-defined functionality through scripting to meet advanced application 
requirements. Setne -The primary of the majo f-goals for the logic and language sub-system 
and supporting workspace functions are: 

1 . Provide tools to allow users to easily engineer and configure dynamic displays 
that interact with the underlying process control system, plant personnel, and other 
display components. These tools should provide access to all component 
properties without requiring the use of programming or scripting (unless desired). 

2. Provide a logic configuration subsvstem that clearly separates the graphical 
display elements from any underlying animation logic that controls the dynamic 
behaviors. 

3. Clearl y separate display logic and dynamic behaviors firom the underlying runtime 
components and services. This is accomplished by not directly accessing any 
runtime libraries or APIs from the display logic, but rather utilizing intermediate 
services to collect, write, and react to the underlying process data. 

4. Leverage language and logic technologies that work equally well across a 
multitude of display devices without the need for any modification or loss of 
functionality (single or multi-monitor displays. PDAs. Cell ular Phones, etc ) 
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5. Leverage drag-and-drop technologies as well_^ wizards and other graphical -based 
tools to automatically generate the code behind the dynamic behavior. 

6. Provide pre-defined/built-in -behavior classes- and -function blocks- for the 
most commonly utilized dynamic behaviors (e.g. color or visibility changes based 
on field device state). 

7. Leverage Starbum^s smart objects and links to forecast or predict the most likely 
wanted behaviors and provide wizards to minimize configuration effort (e.g. pump 
and valve components automatically show consistent dynamic behavior if 
connected by a link). 

8. Allow users to name or "alias" components (both class and instance) within or 
across displays so that both intra and inter-display component communication can 
take place. This includes allowing both local and global scope attributes or 
parameters to be defined and exposed on displays or display elements, which can 
then be used by the display logic to store temporary calculated values or pass 
information between display elements. 

9. Provide tools to view and or edit the script behind the dynamic behaviors if 
required. 

10. Allow for off-line simulation and debugging, including step-by-step logic 
execution and tracing of the underlying script. 
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1, 2 Key Terms 





^escftDiionif:?^^^^ 1^ .Zi^ vMs-:^X>l4^^1irS' 


DisDlav Loeic 


Proerammable script or xml associated with a Starbum eraphtc 




intended to orovide displays with dynamic behaviors and 


interactions. 


Framework Loeic 


DisDlav loeic. which is not customizable bv end-users, and is 




largely shared across displays so that they function in a 


consistent and expected manner. 


Custom Lo&ic 


Display loeic. which is intended for customization by end-users. 




to provide each display with uniaue characteristics and 


behaviors at runtime. 


Dynamic Behaviors 


Properties and methods associated with graphical display 




elements that provide for the elements to take runtime 


interactions and animations based on user and process events. 


Process Dvnamic 


A field input or output that can be assigned to a display element 




such that the underlying display runtime will automatically 


establish subscription-based updates on behalf of the display. 


Runtime worksoace 


The interactive DeltaV applicationf s) that provide the Starbum 




operator interface environment. 


Workspace framework 


The configurable layout of the runtime workspace: how it will 


' If situations arise where custom 


appear on display hardware. 
Ization is reauired in this area, simole hooks or extensions can be added to the 



custom logic, so that again, the framework logic is tightiv controlled and protected. 



1. 3 Types of Display Logic 

There are two basic and distinct types of logic that will ultimately make up a Starbum 
graphic^s display logic. The first is f r-amework logic. The second is custom logic. 

1 .3, 1 Framework Logic 

Framework logic describes all of the logic and script associated with a display that is core to 
the display's ability to function correctly within the overall Starbum system. This type of 
logic will likely be boilerplate in nature, will in some cases be shared across multiple 
displays, and will be hidden and unchangeable from the user's perspective'. Tn this sense, the 
framework logic can be thought of more as a shared set of "library" routines that provide the 
basic functionality for all displays to interact with the Starbum workspace, underlying 
process control system, and one another. 

An example of framework logic might be a well-known, global-scone. JavaScript function — 
OpenDisplav — that can be called by any display component to request another display to be 
opened. Another example of this type of logic would be the framework routine responsible 
for determining what specific control system values are required by a given display at 
runtime in order for the display to function as expected. This routine, or one similar to it. 
might also be responsible for establishing the underlying connections and subscriptions for 
the display so that real-time updates occur seamlessly. In either case, no customer or end- 



' If situations arise where customization is required in this area, simple hooks or extensions can be added to the 
custom logic, so tha t again, the framework logic is tightiv controlled and protected. 
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user editing or modifications would be allowed to this type of logic. Instead, the overall loaic 
and language subsystem would be responsible for generating this type of code whenever 
needed. 

1.3.2 Custom Logic 

The second type of logic, which is the main focus of this document, is custom logic. This 
type of display code is specifically targeted for direct end-user manipulation (either through 
configuration or direct editing"^, such that very specific and custom-interactions can be 
defined for a given display. This type of logic would tend to make a display unique from 
others and would likely be used to drive the overall dynamic behavior of the display at 
runtime. In other words, custom logic would work in conjunction with firamework logic bv 
way of receiving for sending) information fi-om the firamework logic, but then acting on that 
information in unique, non-shared way. 

Custom logic will likely be saved and edited in a one-to-one relationship with a display and 
will not be shared between displays'. 



1. 4 Loaic and Language Concepts & User Needs 
1.4.1_Grapbics and Logic Separation 
i. 4. /. 1 Concept 

One of the more important concepts that ma y be maintained throughout the entire Starbum 
development is the notion of separating the process control and process graphics. Part of 
meeting this requirement is to restrict the underlying display logic firom making direct use or 
calls to the Starbum provided core-runtime services. Instead^ the display logic will rely on 
intermediate runtime-to-display conversion services and utilities to enable graphical depiction 
and c ontrol o f t he plant p rocesses. T his concept i s d iscussed thoroughly i n the- Starbum 
Process Graphics Edit Save. Download. Run General Scenarios document. 

Another requirement of this important separation concept that directly affects the language 
and logic subsystem is breaking the display's graphical elements, ftrkrari.e. User Interface 
(UD co mjjonents and any accompanying programmatic logic, into separate physical storage 
medium s . Separating the display components and associated logic allows for easier 
distributi on, versioning control, and overall management of the distinct parts that make up a 
Starbum graphic (of course in reality, the files work in tandem and while they may load and 
work in a limited fashion without the accompanying sister files, very little of the overall 
expected behavior will function correctly^. Having code and UI components kept separately 
also pro motes good programmatic constructs like abstraction, encapsulation, and code re-use, 
where both SVG-based and JavaScript-based "components" can be combined to build vet 
more re-usable modules. 



' With the special e xception of display classes^ where the majority of the custom logic would be "shared" across 
mstances. and onlv a small piece of logic ( e.g. alias resolution script'^ would be truly unique. 

Displays will likel y be more of a ^logical" concept vs. a physical file, where the "display" is made up of 
potemi^lly several files, some which include graphical elements fSVG. XHT ML, images, etc...^ and some 
mcludmg logic rJayaScriptV 
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/. 4* 1* 2 User Needs 

a. ^ The concept of logic and graphic elements may be transparent to the user at both 

configuration and run-time. Regardless of how the underlying display components 
are organized, from the user^s perspectiye the graphic should feel and maintain the 
appearance of being a single entity . 

b. ) User's will want the ability to quickly test and debug the display logic and its 

interaction with the graphical components. 

• should not require full-sayes and "publishing" of the graphic and logic for 
test 

• relatively "fast" switch between design and test mode 

• ma y present user with accurate prediction of runtime behayior 



Dynamie Behaviors 

Dynamic b e haviors ar e th e basio prop e rties expos e d and aotions taken by the various 
compon e nt s within a display graphic. Th e s e b e haviors provid e th e meohQnism(s) by which 
displays take on the dynamic look and fool based on how th e s e bohavioro have boon 
configur e d and driv e n by th e und e rlying display logio. 

User Needs 

Users wall typically e xp e ct th e behaviors of individual components to follow similar 
configuration r e quir e mentG as do other compononta throughout the Starbum systom ( e .g. 
SFCs, Function Blocks, Equipm e nt Modules, e tc.). This means that, in general, 
configuration of th e b e hav^iors should b e capabl e of b e ing accomplished via dialog bas e d 
prop e rti e s and browse for path ^yp e op e rations. 

There aro likely to be a substantial amount of commonly utilized behaviors and aotions, 
which should b e pr e- d e fin e d bas e d on "behavior class e s". An e xample would b e 
grouping sovoral compon e nts tog e th e r, all of which change color or visibility based on 
the same field devic e trigg e r. 

Users will also typically want to hav e "buddy** components coordinat e th e ir b e haviors 

based on common Gtatos or trigg e rs, and Starbum's smart obj e cts and linlcs should 
provide av e nu e s in which to aid this configuration gr e atly. 

The following is a non exhaustiv e list of som e tho more conunonly us e d dynamic 
behaviors: 

Visibility (hido/show, fla s hing) 

Movement/ Animation 

Enabling/Disabling 

Color 

Rooiging 

T e xt or Caption Changes 
' Albeit with possibly multiple vtews. e.g. "WYSIWYG", "logic configuration", and "code" views. 
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StQto Changoa (doproaood 6uttonG, owitohcs on/ofl) 
Piotur e /Bitmap Ch fmges 

1.4.2 Logic Execution Environments 
1.4.2.1 Concept 

Another important concept associated with the Stef=bw«~graphical language and logic 
subsystem is that it be separated from any particular display device or form factor. In theory 
this should mean any display configured for one type of device, sav a single monitor, should 
at a minimum be "loadable- onto another type of device, say a PDA, without any re-work. In 
reality, due to screen real estate and scaling issues some graphics will not be practical for use 
on certain devices without first being designed for dual purposes. The key point, however, is 
that no display logic component can require a particular type of display device in order to 
present the desired behavior for which it was intended. In general, the technologies targeted 
for the S torbum graphics subsystem. xmK svg, xhtml, javascript, etc-rrr., will go a long way 
intoward meeting this requirement without a tremendous amount of engineering effort* . 

With this concept in mind, the actual display execution environment will most likely be 3"^ 
party SVG viewers, JavaScript interpreters, and HTML browsers (e.g. Internet Explorer, 
Adobe SVG Viewer, etc...)- Whether or not the Starbum Runtime Operator Workspace 
leverages such a 3"* party plug-ins or internally executes the display content in some other 
fashion optimized for single and multiple monitor based systems is immaterial — ^the 
important concept is that both '"rich** and *'thin*' clients will process the same display files and 
utilize an intermediary display server for both distribution and runtime interfacing between 
display and control system dynamicsvariables. 

/. 4. 2. 2 User Needs 

a. ) Users should not require any knowledge of the underlying execution environment 

when configuring displays and its associated logic. 

b. ) Users will need some way to "test" out any display logic being developed in a variety 

of execution environments. This means it will be necessary to emulate as many of the 
targeted platforms as possible on the development machine, without forcing the user 
. actually have all possible devices present during configuration. 

1.4.3 Multiple Display Device Support 
1.4.3.1 Concept 

Starbum's overall architecture is targeted for many types of displays devices and even 
multiple control system I/O (at least DeltaV and Ovation, but possibly more). These 
requirements dictate using two driving principles in all graphic logic: first, separation of 
display fi'om runtime services, and second, utilizing technologies that have no affinity toward 
any given type of display device (see Sections 1.24.1 and 1.24.2). Maybe moreJust as 
important than simplyas using ubiquitous technologies, the display logic may also be aware 
and take advantage of the overall runtime workspace fi:amework (parent panel and 



* Its also conceivable that certain Microsoft technologies* e.g. .Net Remoting» may also be available under this 
constraint as long as all target platforms will function as expected with any such tools. 
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sizes, anc hor point s, automatic scaling, aspect ratios^ etc...^ and automatically decide on the 
**best fit" for a particular display device. This will mean and-re-orienting and re»scaling its 
component to meet the device's capabilities at runtime. 

In order to accomplish this, each display will likely require a "best fit'* set of instructions (e.g. 
possibly held in an accompanying xml-stvlesheet file), which is generated bv the 
configuration system based on the overall runtime oporation V-workspace framework 
and-lavout for a given devicesfsV This file should aid the display's embedded components 
and associated logic to determine information about how, where, and what to render 
depending on the target device. 

1.4. 3. 2 User Needs 

a. ) ar^Users will want to configure displays and logic in an configuration environment 

that depietmimics what the graphic will "look like^ on the target device. 

• decisions can be made regarding real estate and scaling for multiple form 
factors 

• allows users to "picture" what the display will look like across devices 

• requires emulation of display devices firom a view port point-of-view 
(displays m a y be forced into panels of appropriate size during test! 

GO that dooiGions can bo made regarding real ostato and ooaline, 

\Vhilo dooigning displays us e rG will want to so e what that particular display will look liko and 
how it will roaot on the various display targets for which it is intend e d. This will mea n 
e mulating the display and its logic on th e d e v^olopment machine in a "simulat e " mod o f ar 
viewing. 

b. ) If displays are intended for multiple display devices, it may be necessary for users to 

define "styl es" for the display, one for each type of device. If no extra configuration 
is performed, displays will automatically take on "best fit" rules, but they may not be 
suitable in some instances, so configuration input will be required. 

• allows certain components to be hidden on some devices to save space 

• allows for components to be re-located at runtime on some devices 

• allows for user to explicitly control how scaling takes place across form 
factors 



It should be possible for users to "configure" a display (same components, widgets, 
logic, etc. .,) for multiple devices, and to "save" each configuration as one graphic but 
with multiple views or layouts (in some cases, some of the graphical elements will be 
invisible in certain configurations but not in others). 

c.) The user should not be burdened with understanding the technical mechanism taking 
place behind the scenes (whether it be stylesheets, javascript, or display server code) 
to make this one-graphic-multi-display principal"magic" happentake place. They will 
want to know that a single, yet, logical, display graphic entity exists somewhere in the 
system and appears to run seamlessly across multiple devices. 
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1 .4.4 Dynamic Behaviors. Interactions. & Animations 



7. 4. 4. 1 Concept 

Dynamic behaviors are the basic properties exposed and Qotions tak e n b v the various 
components within a display graphic. These behaviors provide the mechanismfs) by which 
displays take on the dynamic look and feel based on how these behaviors have been 
configured and driven by the underlying display logic. 

Interactions are the display logic driven connections between the various components on a 
display that coordinate and synchronize behaviors. For example^ the user clicking a button 
and having that event change the visibility of another component on the same graphic. 
Typically, these interactions will be based on some combination of dynamic behavior 
properties: however, they could iust as well be based on underlying process dynamic events 
(e.g. pump being turned on>. 

Animations are dynamic updates to components that are natively supported bv the SVG 
specification. These behaviors tend to give components the capability to change in a visually 
rich, vet substantively thin way. In other words, animations can be used to "grab" the 
attention of the operator (flashing, spirming. bouncing. etc...\ but do very little to actually 
change the state of the underlying information. Again, almost all of the stock properties of a 
display component can be animated? without the use of special display logic, since SVG 
su pports it natively. 

1.4.4. 2 User Needs 

a. ) Users will typically expect the behaviors of individual components to follow similar 

configuration requirements as do other components throughout the Starbum system 
(e.g. SFCs, Function Blocks, Equipment Modules, etc.). This means that, in general, 
configuration of the behaviors should be capable of being accomplished via dialog- 
based properties and browse-for-path type operations. 

b. ) Users should not have to understand, unless they wish to view and edit the "raw " 

code for the display, how any of the display logic is broken down between SVG- 
based animations vs. JavaScript functions. Regardless of the configuration 
mechanism for display interactions (either with the underlying control system or with 
other components), users should not be presented with choices on how to provide this 
functionality'. 

c. ) The following is a non-exhaustive list of some the more commonly used dynamic 

behaviors: 

• Text 

• Visibility 

• Scale 

• Position 

• Rotation 

• Skew 



'Essentially, there will likely be at least two ways in which to provide certain dynamic behaviors, either through 
native SVG support or by including additional JavaScript. The point is that the language and logic subsystem 
should make this determination for the user, and the user will never know or care which was selected. 
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• Enabled. Disabled 

• Stroke (Pen Size^ 

• Fill Color 

• Stroke Color 

• Gradient (both linear and radial^ 

• Font 

• Font Size 

• Filter 
Images 

• etC.-rrr 



1 .4.5 Behavior Classes or* Scriolets 
1*4*5.1 Concept 

Part of the idea behind the Starbum -development in general is to leverage object oriented 
concepts as much as possib le. paftjeTOFlvparticularlv from the stand -point of engineering 
configuration and productivity. Along these lines, the ideas of class-based displays and 
display compone nts will be made available to end users both for direct re-use or for 
extension. The disp lay language and logic subsystem vyill also take full advantage of code re- 
use and class-based Compon ents' bv utilizing libraries of both SVG and JavaScript 
procedures. Tovyar d this end, the idea of behavior classes will be explored. 

Behavior classes ca n be thought of as an encapsulation of the logic reouired to produce one or 
more of the dynam ic behaviors discussed in sSection 1.34.4. -andThev will allow users to 
configure interactiv e display components to take on q gpocifio behavior bv -assigning" one or 
moreene-suoh behavior clas s es to ono o r m orc to t hose -components, A detailed use case 
scenario is included in sSection r^ ^TBDI of thtfrdocument TTBDI. but a brief description is 
provided as follows. Suppo se a user wishes to have severala partioular widgets on a display 
be invisible upon the initial lo ading of the graphic. Obviously, an advanced user could easily 
delve into the underlying SVG and simply setup the appropriate SVG -animation or 
JavaScript code to accomplish this rather simple task. However, instead he/she could also 
s elect the components of interest, right-click and select the option 4e^Add Behavior^, This 
would then present a list of av ailable behavior classes, possibly with some hints or clues as to 
what each does so selectio n is as easy as possible'. In this case, the user would then 
seteetchoose the b ehavior class ealle^hiddenOnLoad. which would then automatically 
perform the necessary steps w ithin the display logic to make sure that components isare not 
shovyn when the graphic loads. 

There will be potentially a l arge number of behavior classes, each providing some self- 
contained fiinctionalitv, with p ossibly multiple source and multiple target components on 
which the script acts. These be havior classes will be "classes** in the sense that they will act 
on components found in disp lay classes, and will resolve to the correct instance components 
at runtime as expected. 



' The naminR of j^ehavipr clas^^s should make it fairly self-evident bv itself, but tonl ti p s and good context 
sensitive help will also h« r^q^i^^H 
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L4.5. 2 User Needs 

a. ) Users will want to easily recognize and understand, or at least have pretty good guess 

at what the intended functionality of a behayior class is intended to do, A clear, 
precise naming scheme will be important as will adequate tool tips and pood context 
sensitiye help. 

b. ) There are likely a fairly large, vet standard number of dynamic behaviors, 

interactions, and animations that process graphic designers typically utilize when 
putting displays together. The logic and support for a high percentage of these 
behaviors should be "canned" and supplied out-of-the box in the default library of 
behavior classes. 

c. ) Users will want the ability to customize the default behavior classes. by viewing and 

modifying the resulting logic, and, having done so. will want the ability to back- 
import these new behavior classes so they can be utilized in other places. 

1.4.6 Display Logic Configuration 

1,4. 6. 1 Smart Dialos and PropertV'Based Configuration 
1.4.6,1.1 Concept 

In general, most end users will not want to perform large amounts of customization via script- 
based programming. These users will be more comfortable a nd efficient by leveraging a 
more typical dialog/property-based configuration of their display logic. One way to 
accomplish this is to provide tab-like dialog helpers to configure the dynamic behaviors 
behind the display components. These dialogs will fimction in a "wizard" type mode' and 
allow for familiar browse and select- type configuration of component properties and process 
control system parameters. 

This configuration option will also leyerage the ability to associate process dynamiceg 
8 with display components. Process dynamics are used to associate a component's value or 
specific property with a real I/O point within the process control system runtime. For 
example, a static <4€xf>TEXT field might have a module's OUT.CV associated with it. and 
therefore will automatically show the current value whenever the display is loaded. For a 
detailed description and scenario of process dynamics see the document Starbum Process 
Graphics Edit. Save. Download, Run General Scenarios. 

Finally, using the behavior class concept discussed in Section 1.34.5, users will be able to 
graphically configure dynamic interactions and animations behind the components on a given 
display. Along with the behavior classes themselves, users will be able to configure some 
animations simply by using smart*dialog helpers to guide them through a series of 
configuration steps, which establish the desired effect. For example, the user would select a 
button and then start bv bringing up a holpor launch a helper—dialog, which presents a list of 
events supported by the button. The user would select an event, say the Onclick- event, and 
then browse to a target component and select its visible property. Having done this, he/she 
would have associated the target component's visibility with the source button's clicked 



' Not so much from a wizard look-and-feeK i.e. the Next» and «Back type guide, but more from the 
standpoint for helping the user navigate toward the d esired result bv taking into account information already 
known ^bogt |he configuration (graving out superfluous options, presenting filtered h'sts, etc. . V 
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event fsome other configuration options may be presented to further customize the 
interaction, e.g. to set if the visibility toggles, etc.y 

Configuration of display logic roquir e s two di s tinct approach e s, each designed to addr e ss the 
two oxtrcmos of user requirements . In general, most ond users will not want to perform largo 
amounts of customization via script based progromming. Th e s e users will b e more 
comfortabl e and e ffici e nt by l e v e raging a mor e typical dialog/prop e rty bas e d configuration of 
th e ir display logic. On the other hand, th e r e will undoubtedly b e tim e s and circumstanc e s 
under which the standard, out of the box behaviors will not bo adoquato. In those oases, tho 
usor(g) will want to leverage the underlying display logic script to customize and e xtend tho 
default b e haviors to m ee t sp e cial noods. 

1.4.6.1.2 User Needs : Dia l og - Based Configuration 

Each component within a display mu s t b e abl e to onumorato its ovm specific properties 
and/or behaviors, along with any availabl e valu e s so that during configuration, us e rs 
can easily configure tho oomponont(s) by browse and select typ e operations. 

a) Users of this type-will want to be able to configure the component's dynamic 
behaviors (visibility, color, etc..) by selecting from a list of possible triggers 
(possibly a list of module parameters from the underlying control system) and setting 
which values signify what component behavior. 

b) Under more complex scenarios, users may require writing Expressions^- not unlike 
done in other areas of Starbum configurationj^ for example with SFC transition 
e xpr e oDiono. Writing these behavior expressions should require as little code writing 
as possible by providing expression builders and browsing to other display 
components or control system parameters. 

c) Users will want to assign behaviors to groups of components all triggering off the 
same signal. An example might be multi-selecting a group of components on a 
display and assigning to them the ""^HiddenOnLoa d hiddenOnLoair- behavior class 
(doing so would automatically generate the behind the scenes script to set each 
component's visible behavior to false when the display loads). 

d) Users will expect dialogs to take into account as much knowledge about the situation 
as possible and to present choices, which make the most sense in that light. However, 
if wanted users will need the ability to override this intelli-sense, and to configure 
what might seem an unlikely scenario (for example select a button and circle, and 
have the circle be the "clicked" object and the button be the "target"). 

Users will want to assign components or groups of components to various layers within a 
display (for concepts on layers see the Starburn Runtime Operator Workspace 
Concept document). Assigning a component to a particular layer will automatically 
associate the component's behavior and logic (e.g. data gathering script or visibility) 
with that layer's state. 

Users will need to associate various components with runtime or possibly historical data. For 
example, a slider bar component might be associated directly to an analog output. This 
should be accomplished by browsing to the module and having the varioiis component 
properties (max., min., etc..) configured automatically. 
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1.4.6. 2 Function Block^Based Losic Con/ieuration 

1.4.6.2.1 Concept 

Many of the other configuration and engineering tools found within Stefbttm-urilize the idea 
of function blocks to configure logic. In this situation, the *iogic" is encapsulated in a 
graphical block, which performs a very specific and self-contained task (very similar to the 
aforementioned behavior class). Each block can then be linked to other blocks yia a series of 
connecting lines?, which themselves serve as inputs or outputs to the other logic blocks. A 
dotoilod Goonario io inoludod in Section T?.?.?|"TDB] of this dooumont fTBD]. but e Gsentiallv ; 
this concept allows users to again graphically configure the dynamic behavior and 
interactions of the components found in a display. Like the idea of behavior classes, in the 
end, the display subsystem ultimately translates these function blocks into JavaScript code 
that becomes part of the overall display at runtime. 

1.4.6.2.2 User Needs 

a. ) Users will want a rich and fairly complete library of function blocks available that 

they can use to configure a wide-variety of dynamic behaviors. These blocks should 
be well named and provide tool tips to help users as they configure their displays, 

b. ) Users will want the ability to group a set of blocks together and the import this 

"composite** back into the library to be used again in later situations. 

c. ) Users may want to customize a single function block's behavior by modifying the 

underlying script logic and then save and import the new block back into the library 
for re-use. 



1.4.6.3 ScripUBased Logic Configuration 



1.4.6.3.1 Concept 

There will inevitably be as small set of users that for any number of reasons either want or 
require the ability to directly edit and modify the logic of a display directly. These users will 
actually open and edit both the SVG and JavaScript behind a display and then test and debug 
the result. 

1.4.6.3.2 User Needs: Script-Based Configuration 

Advanced users, or those more familiar with programming/scripting constructs may want 
or need to configure display logic and behavior in a more powerful and direct way 
than possible through dialog-based or function block-based configuration. For this 
reason, all component dynamic behaviors must be actually governed by a behind-the- 
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oo e n e o ooripting languago* Th e so us e ro will oxpoot to dovolop in an e nvironm e nt 
very similar to todoy*o advanood IDEa, like Viaual Studio .Not, 



a) To facilitate this both tho non - progrQmmer and soript - savy usora ^ displays will require 
at least two distinct "views ". Tho first io a e-"form" view, which shows the user the 
current graphical layout of the form displav. and a . Tho sooond io a **code" view, 
which allows the user to edit and view the script behind the graphical components. 

b) Users will not be allowed to break any of the overall design constraints of the 
Starbum graphics, which means the editing environment cannot allow direct access to 
runtime APIs or other constructs that would break the one-display-many-devices 
concept. 

Users will most likely want to maintain some type of versioning and control over the 
script behind the display, and this will need to be taken care of using VCAT or the 
like. 

c) Users will expect editing tools that increase productivity — Some-type ofsyntax 
checking, well-named auto-generated code, code navigation tools (find, goto, replace, 
etc.), intelli-sense and auto-complete functionality which lists the various display 
components and individual properties/behaviors will be required to ease codincolor 
coding, etc.g. 

Users will want to easily determine what code belongs to which component(s), so well 
named auto-generated functions and event handlers will be important. 

Users will want to leverage other Starbum APIs from within the display logic (e.g. 
process history, alarms and events, advanced control, etc.), so the scripting 
enviroiunent should support this type of integration. 

In some cases, users may want to integrate 3"* party based information by using 3"* party 
APIs, and thus the scripting environment should facilitate this to some degree^. 

1.4.7 Inter and Intra Inter and Intra Display Component Communications 
L4. 7.1 Display Variables and Contexts 
1.4.7.1.1 Concept 



' Most likoly thio language will cither bo J S cript or Ctf, but othcro moybo oonaidorcd. It olao br i nes up tho i ssue 
oFwhot iotho oxooution env i ronment of thio oor t pt. 

^ This opens some fairly complex issues regarding security and performance so it may only be "supported" in 
limited ways. 
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This model illustrates the fact classes of DeltaV Expert 
DeltaV. Expert. Model 




Figure 7 - Rule Class Diagram 
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4.2 Use Cases 
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4.2.1 New expert module 

4.2.1.1 Pre condition(s) 

a) Expert Studio is open 

4.2.1.2 Post condition(s} 

a) A new expert module will be created and saved to the database. 



4.2.1.3 User Actions/ System Response 



ilser^Attiohs ' ; t 1 ? : 


System Resoonse . . « ^ 


User clicks ^^new" In Expert Studio 


The application will create a blank DeltaV Expert 
Module 





ObpUiyRMteTefnplate< RuleTemplste ) 










IllnStSwDgTvlfl 





5 : anrayOfFactTValyes :« 
*OetPropertles( parentHandio ) 




OisplayFactTenvlateC FadTemplate > 



8 : anayOIRuleTVftlues 
'GetPn>pertte»( parentHandle ) 



3 : Handle 

exscuteCommandC -GetExpenUbrary ) 



Figure 9 - Object collaboration diagram for creating a new expert module 
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4.2.2 Open existing expert module 

4.2.2.1 Pre condition(s) 

a) At least one expert module has already been saved in the database. 

4.2.2.2 Post condition(s) 

b) At least one expert module has already been saved in the database. 



4.2.2.3 User Actions/System Response 



User Actions : * 


System Response- rV 1. 7 ... 77' .7 Z 1" Z' 


User clicks "open" In Expert Studio 


A dialog box will appear giving a user the choice of 
what module to open based on a list of existing 
expert modules. 


User selects a module and clicks "OK" 


The application will attempt to load the user- 
specified expert module in Expert Studio. 




15: 

ObpCayFaciTeinpiaief FaaTempiata ) 



Figure 10 - Object collaboration diagram for opening an existing expert module 
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4.2.3 Edit expert module - Add fact 

4.2.3.1 Pre condition(s) 

a) An existing expert module is opened in Expert Studio 

b) The expert module may not be assigned for execution 

4.2.3.2 Post condition(s) 

a) All applicable changes to opened expert module will be saved in the database. 



4.2.3.3 User Actions/System Response 



Uier A^bris 


System Response 


User drags a fact from the template view and 
drops it to the expert view 


System will show a dialog displaying default and/or 
blank facts properties. 


User flils-up fact properties 




User clicks on ''Save" from the fact dialog 


System creates, saves and assigns the fact to the 
working expert module 



TvUbrary.ltBmOrBoO 

A, TvMQgma.otagOw 




VBfid«tePorType()^ 



VaOdalBFotADowwISynntolsO 



Figure 11 - Object GOllaboration diagram for creating a new fact in an expert module 
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4.2.4 Edit expert module - Modify fact 

4.2.4.1 Pre condition(s) 

a) An existing expert module is opened in Expert Studio. 

b) There may be at least one existing fact 

c) The expert module may not be assigned for execution 

4.2.4.2 Post condition(s) 

a) All applicable changes to the modified fact will be saved in the database. 



4.2.4.3 User Actions/System Response 



User Actions ^ ' v " . 


; Sysfem Respbhse- : : „ : : l : 1 


User right clicks on an existing fact and 
chooses the ^'Properties" context menu 


System will show a dialog displaying existing fact 
properties. User may use this dialog to view 
detailed fact properties or modify them. 


User modifies fact properties 




User clicks on '"Save" from the fact dialog 


System saves user changes to the fact in the 
database. 




23: 

valkf«teForAltow«dSyin&oliO 



Figure 12 - Object collaboration diagram for modifying a fact in an expert module 
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4.2.5 Edit expert module - Delete fact 



4.2.5.1 Pre conditlon(s) 

a) An existing expert module is opened in Expert Studio. 

b) There may be at least one existing fact 

c) The expert module may not be assigned for execution 

4.2.5.2 Post condition(s) 

a) Fact will be deleted from the database. 



4.2.5.3 User Actions/System Response 



User Actions 


System Response . . : * ; 


User right clicks on an existing fact and 
chooses the "Delete" context menu 


System will show a dialog asking the user for 
confirmation on the delete action. 


User clicks on "OK" from the confirmation 
dialog 


System removes the fact from the expert module 
and the database. 



user 



DeleteFactO 



2 : success :» 
OeleteFacU Descriptor ) 



9: 

RefresKO 



I 3 : success 

^ Oelete( Descriptor ) 



7: 

Delete( this ) 



iDeleteO 



8 : success 



ExecuteCommand( *DeleteFact*. factHandle ) 



3 



I 4 : ExpertBase 
TGetMe( Descriptor) 



IsAssignedForExecutianO 



Figure 13 - Object collaboration diagram for deleting a fact in an expert module 
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4.2.6 Edit expert module - Add rule 



4.2.6.1 Pre Gondition(s) 

c) An existing expert module is opened in Expert Studio 

4.2.6.2 Post condltlon(s) 

b) Ail applicable changes to opened expert module will be saved in the database. 

4.2.6.3 User Actions/System Response 



User Actions 


t System Response 


User drags a rule from the template view and 
drops it to the expert view 


System will show a dialog displaying default and/or 
blank rule properties. 


User fillS'Up rule properties 




User clicks on "Save" from the rule dialog 


System creates, saves and assigns the rule to the 
working expert module 




Figure 14 - Object collaboration diagram for creating a rule In an expert module 
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4.2.7 Edit expert module - Modify rule 

4.2.7.1 Pre condition($) 

d) An existing expert module is opened In Expert Studio. 

e) There may be at least one existing rule 

0 The expert module may not be assigned for execution 

4.2.7.2 Post condltion(s) 

b) All applicable changes to the modified rule will be saved in the database. 



4.2.7.3 User Actions/System Response 



LUser Actions 


[ System R^sptjojh^: ' : ' : ' ' '[ * - '~V'- • 


User right cliclcs on an existing rule and 
chooses the '^Properties" context menu 


System will show a dialog displaying existing rule 
properties. User may use this dialog to view 
detailed rule properties or modify them. 


User modifies rule properties 




User clicks on "Save" from the rule dialog 


System saves user changes to the rule in the 
database. 




BxMuiaComniandf UpdatoRuM", values 1 

Figure 15 - Object collaboration diagram for modifying a rule in an expert module 
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4.2.8 Edit expert module - Delete rule 



4.2.8.1 Pre condltion(s) 

d) An existing expert module is opened in Expert Studio. 

e) There may be at least one existing rule 

f) Hie expert module may not be assigned for execution 

4.2.8.2 Post condition(s) 

b) Rule will be deleted from the database. 



4.2.8.3 User Actions/ System Response 



lUser Actions ^. . ', ' -1 4 ^ V r Vi, 


System^Response * * ' t* L * , 


User right clicks on an existing rule and 
chooses the ^'Delete" context menu 


System will show a dialog asking the user for 
confirmation on the delete action. 


User clicks on "OK" from the confirmation 
dialog 


System removes the rule from the expert module 
and the database. 



1 : 

DeleteRuteO 



2 : success :- 
DeleteRiJle( Descriptor ) 



— ► 

8: 

RefreshO 



Oeiete( this ) 
^ — 




t 4 : ExpertBase :^ 
iGetMeC Descriptor) 



ExecuteCommand( 'OeleteRule*. ndeOescriptor ) 

Figure 16 - Object collaboration diagram for deleting a rule in an expert module 

4.2.9 Debug 

4.2.9.1 Pre oondition(s)s 

4.2.9.2 User Actions/ System Response 



•user Actions * * T I : L : . * 


ilSystem. Rtesponse ' <^ • ^ 
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4.2,10 Assign module for execution 
4.2.10.1 Pre Gondition(s)s 



4.2.10.2 User Actions/System Response 



4.2.11 Delete module 

4.2.11.1 Pre condition(s)s 



4.2.11.2 User Actions/System Response 



4.2.12 Download 

4.2.12.1 Pre condition(s)s 



4.2.12.2 User Actions/System Response 
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Process Simulation Configiiration 
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1 Introduction 



1.1 Overview 

Process Simulation is a new feature in the OeltaV System that will allow plant operations to be 
simulated in DeltaV for both process optimization and operator training purposes. The process 
simulation package will have a configuration editor and an online mode. This document describes use 
cases for the configuration editors. 



There are two editors needed to configure the process simulation. The process element and the 
process module editors. 

a. ) Process Element Editor 

The Process Element Editor provides a way to create process elements which becomes the 
basic building blocks of a process module. 

b. ) Process Module Editor (Offline and Online mode) 

The process module editor allows the composition of a process module by inserting and 
connecting process and elements to simulate process plant scenario. 

1.2 Definitions 

1.3 References 

1 .4 Deliverables 

1 .4.1 Process Element configuration editor 

1 .4.2 Process Module configuration editor. 

2 Objectives 

The objective for this prototype Is to define and show user scenarios pertaining to simulation 
process configuration and to investigate plausible ways of interfacing with the Starburn Client 
Model, the Diagram Control, the Starburn Controls, and the Workspace. 
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User Interfaces 



Configuration Workspace 



Menu 



Tool Bars 



Tree Vievt 

CONNECTIONS 

Steam 

Air 

Fuel 

Water 

Exhaust 



Create Graphic 
View 



Parameter l/iew 

Diameter 
Height 



Initial 



Run 



Post 



Number of Paths : 2_ 

Number of Inputs : 3_ 

Number of Outputs: _2_ 



Name : 
Type : 


INI 
Steam 


IN2 
Air 


!N3 
Fuel 


OUTI 
Water 


OUT2 
Exhaust 


Pathl: 
rath2: 


X 


X 


X 


X 


X 



Alarms 



New alarms 



Figure 1 — Process Clement Editor 
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Configuration Workspace 



Tree View 
CALCl 
Dl 



Parameter View 



Menu 
Tool Bars 



Diagram View/ Diagram Controi 



Alarms 



CALCl 












DU 







Library 



Tank 
Pump 
Valve 



Figure 2 — Process Module Editor 



4 Object Model 
4.1 Design Diagrams 

This object model illustrates how Process Module Objects are mapped Into the existing model. 
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Figure 3 — Process Module Object Model 
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Use Cases 




Figure 6 - Process Module Use Cases 
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4.3 Create Process Element "Tank" using Process Element Editor. 



4.3.1 Pre Condition 

Process Element Tank" does not exist. 

4.3.2 Post Condition 

Tank created with algorithm. 

Tank has properties diameter, height, number of inputs, number of outputs, alarms added. 

4.3.3 Scenario 

1 . Use launches Process Element Editor. 

2. Process Element Editor loaded into Workspace as a Package. 

3. Package loads "blank". 

4. User selects "New 

4.1 Editor presents "New^ dialog. 

4.2 User selects "Embedded Algorithm". 

4.3 Editor selects process element "Untitled" with ST algorithm. 

4.4 Editor creates Tree View. Parameter View, and Tabbed Content with algorithm entries for 

"Initial". "Run" "Post", "IN" and "OUT*. 

5. User defines Inputs/Outputs/Paths . 

5.1 User selects Input/Output/Path tab. 

5.2 User sets number of Inputs = 3. number of Outputs = 2, number of paths = 2. 

5.3 User sets name, type, etc, for each inputs and outputs. 

5.4 User defines path. 

6. User defines Parameters. 

6.1 User selects Parameter View. 

6.2 User adds parameter "Diameter", 

6.3 User adds parameter "Heighr. 

7. User defines Alarm. 

8. User defines Initial algorithm. 

8.1 User selects "Initial" tab. 

8.2 Editor presents ST Editor. 

8.3 User enters ST. 

9. User defines Run algorithm. 

10. User defines Post algorithm. 

1 1 . User selects "Save" Process Element as "3_lnput_Tank". 
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4.3.4 Collaboration Diagram 



4.4 Create Process Module "TankMod" using Process Module Editor 

4.4.1 Preconditions 

Process Module Package is Open with no current process module. 
Mode is Immediate update. 

4.4.2 Postconditions 

Process Module TANKMOD' created. 

4.4-3 Scenario 

1 . User selects File - New. 
Editor presents New Dialog. 

2. User selects New. 

Editor creates "Untitled" Process Module in DB & replicate. 

3. User places elements on diagram. 

- Stream start 

- Pump 

- Valve 
• Tank 

- stream end 

4. User connects with wires - for each link. 

4.1 Select Connection tool. 

4.2 Click on start Connector. 

4.3 Click on end Connector. 

5. User selects File-Save As with name "TankMod" 
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4.5 Create Process Module "TankMod" using Process Module Editor from a 
"Template" 



4.6 View Online Mode using Process Module Editor 
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Process Modules 
for 

Improved Control, Abnormal Situation 
Prevention, and Simulation 
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1 Introduction 



1 .1 Overview 

Using Process Simulation for Operator Training, Plant Design, and lO Checkout is not a new idea. 
The current versions of DeltaV provide an interface through OPC with documented extensions to 
DeltaV to allow simulators such as Mimic and HYSYS to exchange parameters and control the 
simulation\ The current technology, however, is not integrated in several important ways including 
configuration, alarming, and control. 

Adding new capabilities to process graphics makes It possible to both add new behaviors and 
integrated customized behaviors with graphical items. These capabilities can be exposed *'behind- 
the-scene" as Process Graphic Displays are built. These capabilities are exposed in what we refer to 
as "Process Modules". 

This concept document summarizes the requirements for the integration Process Graphics and 
Process Modules. 

1.2 Objectives 

The objectives for this project are: 

1 . Improve Control 

2. Reduce plant shutdowns through Abnormal Situation Prevention 

3. Reduce project engineering effort 

4. Provide a framework for Operator Training 

5. Improve integration with High Fidelity Simulation Applications 



1.3 Definitions 



Term 


Definition 


Graphics 
Primitives 


These are built into the display configuration model along with their behavior. These 
include lines, polylines, ellipses, arcs, rectangles, text, Images, composite (group). 
Each primitive in the editor has an SVG equivalent (although one editor primitive may 
be translated into multiple SVG objects, e.g. multi-line text, gradient filled objects etc.) 
User variables can be associated with any primitive. Variables are used by dynamic 
behaviors to control the algorithm and how items are displayed. 


Graphics 

Group 

(composite) 


Graphics primitives and other groups can be grouped together to form a grouped Item 
which can behave as a single entity for editing purposes. User variables can be 
associated with any group. Variables are used by dynamic behaviors to control the 
algorithm and how items are displayed. 


Component 
Primitives 


Pre-built components that are built by EPM and distributed as components. 
Component Primitives have built-in behavior which can range from simple to 
complex. Component primitives have behavior which allows them to be configured. 
These components are for providing specialized interactions or controls. E.g. Trend 
controls, advance control interactions etc. 


Process 
Graphic Item 

(aka - Library 
Hem, either 
Template or 


Are pre-built single primitives or groups, including any defined variables and dynamic 
behavior. We will provide libraries of composites for common control equipment such 
as PUMPS, VALVES etc. Users can also create their own library of composites. 
Library items can be treated as templates, in which case a copy of the item is made If 
it is placed on a display, or classes in which case a link to the library item is made if it 
is placed on a display. When an instance of a class Is created on another display the 



' Current Simulate packages allow the users to enable simulation, perform fast save/restores, etc. 
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Term 


Definition 


Class) 


user can override the public parameters defined in the class, together with its 
viewport characteristics (position, size and rotation). 


uispiay 


M Qispiay 19 a grapnics group wnicn is capauie oi ueiny uidpiaytsu inuepcsiiuoiiuy. ii 
includes the definition of the "canvas" on which the display is drawn (its size, 
background color or background image). Public variables defined for a display can 
be used as parameters when the display Is called up. For example, the color of 
pipework for a display could be controlled by a variable PIPEWORK_COLOR. When 
the display is called up the parameter PIPEWORK_COLOR could be set to blue. 


Display Class 


A display class is extremely similar to a display except that one or more of its public 
parameters are used as an alias in process value paths. For example, a display 
class could have process value paths including the alias MODULE (e.g. 
//#MODULE#/ATTR.FIELD). MODULE itself is a parameter of the display. When the 
display is called up the parameter MODULE could be set to FIC-101A. 


Display 
Template 


is exactly the same as a display except that it is placed in the library rather than 
associated with a particular equipment item, module, or item of hardware. A display 
template can be used as a starting point for creating displays. 


Process 
Objects 


Library items can be tagged. Tagged graphical items can be referenced by other 
configuration items as well as the runtime. Smart Process Objects are normally 
equipment items such Valves, Pumps. Tanks, Heaters, Mixers, etc. 


Process 
Links 

(Streams) 


Smart Process Links are also referred to Streams in other simulation and optimization 
packages. Smart Process Links can have compositions associated with them. When 
they compositions associated with them the compositions flow along the stream 
through the Smart Process Objects. Smart Process links can also have calculations 
associated with them. This allows other them to be referenced by other configuration 
items as well as the runtime. They are most often associated with Pipes. 


Process 
Algorithm 


Similar to existing algorithm types, Process Algorithms are defined for generalized 
use. Each process graphic may have a process module associated with and a 
process algorithm defined for it. Algorithm types include Mass Balance, Energy 
Balance, Simple Composition, Routing, Efficiency, Optimization, Economic 
Calculations, as well as custom algorithm types. 


Process 
Module 


Can be defined for Process Graphics. They have special properties including. Mode, 
Status, and Alarm Behavior. Can be assigned to workstations. Execute process flow 
algorithms. 


Smart 

Process 

Database 


Stores information about Smart Objects, Links, Algorithms, and Modules. Similar to 
Component and OO Design tools, the database will allow the users to define multlpie 
views against the same database items (e.g. class diagrams, state diagrams, 
collaboration diagrams, etc.) 















1.4 References 
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2 Requirements 



2.1 General 

1 . Improved Control — Provide the following calculations 

a. Mass Balance. 

b. Energy Balance. 

c. Simple Composition. 

d. Custom Calculations. 

2. Abnormal Situation Prevention - the interface includes: 

a. Using improved control calculations generate alert messages. 

b. Integrate specialized calculations from other Emerson Process Management 
divisions. 

c. Integrate specialized calculations from 3*^ parties or customers. 

3. Reduce project engineering effort - the reduction In engineering efforts Is achieved for 
several reasons: 

a. lO and Process checkout. 

b. Elimination of duplicate display and simulation configuration when engineering 
systems with simulation requirements. 

4. Provide a frameworic for Operator Training - the framework includes: 

a. Smart process graphics that can be used for process simulation and process 
calculations. 

b. Process Graphics include dynamics from both Control Environment as well as 
Process Modules. 

5. Improve integration with High Fidelity Simulation applications - the improvements over 
what Is in-pface today Includes: 

a. Interface for exchanging runtime configuration. Included In the exchange will be 
parameter reference information and data type information. 

b. Interface for exchanging Operator Commands. 



2.2 Process Graphic Elements 



A set of predefined graphic elements will be provide for the construction of operator displays. These 
elements may be designed to dynamically show on-line measurements and actuators that Interface to 
the OeltaV control system. In addition, unmeasured parameters that reflect process operation may be 
calculated using on-line process simulation and may be shown as an integral part of the associated 
graphic elements. 



In an offline environment used for engineering or training environment, the graphic elements will 
automatically show measurement values base on process simulation. These values calculated by 
process modules may be based on the actuator position or state as well as manual disturbance 
values. Process modules will be automatically created from the graphic elements used to construct 
the operator displays. 
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The static portion of the graphic elements will In many cases appear similar to the 3D components 
included in the ifix graphics library. In this section, details will be provided on this library of graphic 
elements, information displayed with these elements and their link to the control system I/O and 
process simulation modules. 



2.2.1 Process Connections 



In many processing plants, the step associated with manufacturing may involve handling solid 
materials, liquid and vapor, and gases. To clearly illustrate the material flow through the process, 
three different types of process connections will be support. 

• Piping - for liquid and high pressure vapor or gas flow 

• Duct - for low pressure gas flow 

• Conveyor - for the movement of solid material between processing units. 

The properties of the material that is transferred by a connections are determined by the upstream 
input. This Information plus the connection status are available as properties of the connection. The 
elements that may provided this upstream input are the following: 

• Processing element Output 

• Actuator element Output 

• Stream element Output 

The properties of a connection will be automatically displayed when the cursor is placed over the 
connection. Also, the properties associated with a connection may be exposed for permanent display 
by placing a measurement or estimated property element on the connection - see section on 
measurement and estimated property elements. 

A connection element may terminate at one of the following elements: 

• Processing element Input 

• Actuator element input 

• Stream element input 

A connection may be created by holding the left mouse button down over a element Output and while 
holding down the mouse position the cursor over an element Input. For the connection to be 
established successfully, the input and Output types (pipe, duct, or conveyor) of the upsteam and 
downstream elements may match. The connection will automatically take on the type of the upstream 
element. 



2.2.1.1 Piping 

The flow of liquid, high pressure vapor, or high pressure gas 
between processing elements will be shown as a pipe connection. 
Piping connections will automatically be routed between 
processing elements and arrows displayed outside the pipe to 
show the direction of the flow. If an upsteam Output is common to 
two connections, then depending on the placement of the 
downstream elements, a common line will be shown for part of the 
connection and branching automatically shown as a "T" In the 
pipe, as illustrated below. 

The pipe connection element will dynamically reflect the following: 

• Connection lost - color change. 

• Selected property is outside configured limits -color change 
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Based on the process simulation, the following calculated parameters may be exposed: 

• Properties provided by the upstream connection 

• Connection status - good/bad 

The following may be configured for this element: 

• Limits on selected parameter, color change if outside of limit 



2.2.1.2 Air/Gas Duct 

The flow of low pressure vapor or gas between processing elements 
will be shown as a duct connection. Duct connections will 
automatically be routed between processing elements and arrows 
displayed outside the duct to show the direction of the flow. If an 
upstream Output Is common to two duct connections, then depending 
on the placement of the downstream elements, a common duct will 
be shown for part of the connection and branching automatically 
shown as a "T" in the duct, as illustrated below. 



The duct connection element will dynamically reflect the following: 

• Connection lost - color change. 

• Selected property is outside configured limits -^olor change 
Based on the process simulation, the following calculated parameters may be exposed: 

• Properties provided by the upstream connection 

• Connection status - good/bad 

The following may be configured for this element: 

• Limits on selected parameter, color change if outside of limit 



2.2.1.3 Conveyor 

Solid materials are used or produced by 
many processes in Industry. Examples are 
in the pulping process wood chips are 
transferred from the woodyard to the 
digester house. In the power house, solid 
waste material such as bark may be used 
by the boiler. Plastic pellets are the 
feedstock to an extruder. The final product 
of a spry dryer or kiln Is a solid material. 
Ore processing in metals and mining makes 
extensive use of conveyors. 

The material flow along a conveyor is determined by the motor drive connected to the 
conveyor. Thus, a motor drive actuator may be connected to a conveyor - see motor 
drive actuator. 

Conveyor connections will automatically be routed between processing elements 
inputs and outputs defined for conveyor connection. Arrows displayed along the 
conveyor to show the direction of the flow. The color of the conveyor will change to 
Indicate its status i.e. running or stopped. Also, by connecting a measurement 
element to the conveyor, it is possible to expose measurements associated with the 
conveyor e.g. speed or with the material e.g. moisture or weight. Also, the expose 
property element may be added to the conveyor to display properties that are not 
measured e.g. composition. 
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The conveyor connection element will dynamically reflect the following: 

• Connection lost - color change. 

• Selected property is outside configured limits -color change 

Based on the process simulation, the following calculated parameters may be 
exposed: 

« Properties provided by the upstream connection 

• Connection status — good/bad 

The following may be configured for this element: 

• Limits on selected parameter, color change is outside of limit 



2.2.2 Process Actuators 

Actuators may be placed between process connects or between processing elements and a 
connection. In some cases an actuator may be used with a specific connection type i.e. pipe, duct 
conveyor, as defined below: 





Pipe 


Duct 


Conveyor 


Regulating valve 


X 






On-Off Valve 


X 






Pump 


X 






Eductor 


X 






Force Draft Fan 




X 




Induced Draft Fan 




X 




Damper Drive 




X 




Feeder 


X 




X 


Motor Drive 






X 



2.2.2.1 Regulating Valve (with actuator) 

The regulating valve element will dynamically reflect the following: 

• Implied valve position - animation. 

• Valve full open/ctosed - color change 

• AO setpoint. PV, OUT mode ~ numeric, string 

Based on the process simulation, the following calculated parameters may be exposed: 
Discharge pressure 

• Mass flow 

• Liquid temperature 

• Liquid composition 

• Discharge pressure 

The following may be configured for this element: 

• Reference to AO associated with the valve 
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• Valve type -linear, quick opening, equal percentage (Sim FB) 

2.2.2.2 On-Off Valve (with Actuator) 

The on-off valve element will dynamically reflect the following: 

• Valve full open/closed/transition - color change 

• Valve fail - color 

• DO or DC setpoint and mode -string 

Based on the process simulation, the following calculated parameters may be exposed: 
Discharge pressure 

• Mass flow 

• Liquid temperature 

• Liquid composition 

• Inlet pressure 

The following may be configured for this element: 

• Reference to DO or DC block associated with the valve 

• Stroke time from close to open (Sim FB) 




2.2.2.3 Manual Valve (Instructor Layer Only) 

Manual valves are typically located upstream and/or downstream of 
regulating valves. Since manual valves directly impact the operation of 
the process, these elements may be Included in the process simulation. 
To allow local valves included in the simulation to be adjusted by the 
training instructor during off-line simulation, a graphic element will be 
provided to represent the manual valve. This graphic element may be 
included in the instructor layer of the graphic display. The state of the 
valve (open/closed) will be indicated by the color of the valve. 




2.2.2.4 Pump (with Motor) 

The pump element will dynamically reflect the following: 

• Motor status - color change 

• DC mode and setpoint - strings 

• Motor speed (if variable speed drive) - numeric 

• AO setpoint, PV, OUT mode (if variable speed drive) - numeric, string 
Based on the process simulation, the following calculated parameters may be exposed: 

• Discharge pressure 

• Liquid composition 

• Liquid temperature 

• Mass flow 

The following may be configured for this element: 

• Reference to associated DC block for motor start/stop 

• Reference to AO for variable speed drive(if used) 
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Pump curve - pressure vs flow (Sim FB) 




Force Draft Fan(wlth Motor) 

The force draft fan element will dynamically reflect the 

• Motor status — color change 

• DC mode and setpoint - strings 

• Motor speed (if variable speed drive) - numeric 

• AO setpoint. PV. OUT mode (if variable speed drive) - numeric, string 
Based on the process simulation, the following calculated parameters may be exposed: 

• Discharge pressure 

• Gas composition 

• Gas temperature 

• Gas mass flow 

The following may be configured for this element: 

• Reference to associated DC block for motor start/stop 

• Reference to AO for variable speed drive(lf used) 

• Fan curve - pressure vs flow (Sim FB) 



following: 



.6 Induced Draft Fan( with Motor) 

The induced draft fan element will dynamically reflect the following: 

• Motor status - color change 

• DC mode and setpoint - strings 

• Motor speed (if variable speed drive) - numeric 

• AO setpoint, PV, OUT mode (if variable speed drive) - 
numeric, string 

Based on the process simulation, the following calculated 
parameters may be exposed: 

• Gas composition 

• Gas temperature 

• Gas mass flow 

The following may be configured for this element: 

• Reference to associated DC block for motor start/stop 

• Reference to AO for variable speed drive(if used) 

• Fan curve - pressure vs flow (Sim FB) 




.7 Eductor (with On-off Valve) 

. xyz 

a. abc 
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2.2.2.8 Damper (with Drive) 

2. xyz 

b. abc 




2.2.2.9 Feeder (with variable speed Motor) 

3. xyz 

c. abc 




2.2.2.10 Conveyor IMotor Drive 

The motor drive may be attaclied to a conveyor element 




2.2.3 Measurements and Property Elements 

The transmitter element Is used In the display to access the measurement value associated with a 
physical transmitter or switch. This element can be added to a connection element or to a processing 
element. When a transmitter element is added to the display, the user may identify the associated Al. 
PCI or Dl block in DeltaV. In the on-line mode, the value of the measurement will be shown next to 
this measurement element. In the off-line mode the simulated value of the measurement will be 
automatically displayed based on the value calculated by the associated process simulation module. 

An estimated property element may be added to a connection or processing element to display any 
property of that element. When this element is placed on a connection or on a piece of equipment 
then the user can browse and select the properties that will be displayed. Thus, properties that are 
not available through a physical measurement may be exposed through the use of the estimated 
properties element. 
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In this section, we discuss the elements provided for process measurement and for accessing 
estimated properties calculated by the process simulation modules. 



2.2.3.1 Transmitter Element 



xxx.xx GPM 



The transmitter element will dynamically reflect the following: 

• Bad or uncertain status - color change 

• Mode of associated Al ( Manual or OS) — color change 

• Measurement value and units - numeric and string 

When in off-line simulation mode, the following parameters may be access and changed: 

• Select simulation value or manual value and status for display - boolean 

• Manually entered value and status of measurement 
The following may be configured for this element: 

• Reference to associated Al or PCI block for measurement 

• Reference to the simulated property that this measurement reflects (Sim FB) 



HI Level 



2.2.3.2 Physical Switch 

The physical switch element will dynamically renect the following: 

• Bad or uncertain status - color change 

• Mode of associated Dl in Manual or OS - color change 

• Switch discrete value-string 

When in off-line simulation mode, the following parameters may be access and changed: 

• Select simulation value or manual value and status - boolean 

• Manually entered value and status of switch 
The following may be configured for this element: 

• Reference to associated Dl block 

• Reference to the element property that triggers the switch (Sim FB) 

• The limit and deadband associated with change of state (Sim FB). 



2.2.3.3 Estimated Property 

The estimated property element will dynamically reflect the following: 

• Good/Bad connection - color change 

• Estimated property value(s) - numeric 

• Property outside limit - color change 

The following may be configured for this element: 

• Reference to property(s) to be displayed (Sim FB) 

• Limits and color change if outside of limits (Sim FB) 
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2.2.4 Processing Elements 

Plant equipment other than measurements and actuator and connection will be represented in the 
operator display as processing elements. All inputs and output to a processing elements \A/ill be made 
through connection elements. Standard processing elements will be provided for the following plant 
equipment: 



• 


Tank - vertical 


• 


Tanks - horizontal 


• 


Heater 


• 


Static Mixer 


• 


Reactor 


• 


Mixer 


• 


Air Heater 



For these standard processing elements, the user may specify the number of inputs and outputs to 
and physical equipment properties e.g. size. The simulation algorithm and static representation of 
these standard processing elements may not be modified by the user. 

All other plant equipment will be implemented as custom processing elements. The static 
representation, number of inputs and outputs and the simulation algorithm may be modified to meet 
the user interface requirements. Once a custom processing element has been defined, it may be 
saved as a template that may be reused or used as a starting point in the creation of other processing 
elements. 



2.2.4.1 Standard Processing Elements 

2.2.4.1.1 Tank - Vertical 

Based on the pipe connections to the vertical tank, 
the tank element will dynamically reflect the 
following: 

• Level in the tank - dynamic animation 

• Level at 1 00% or empty - color change 
Based on the process simulation, the following calculated parameters may be exposed: 

• Outlet temperature 

• Outlet composition 

• Liquid temperature 

• Simulated level 

The following may be configured for this element: 

• Number of Input and output connections 

• Complete connections to the tank 

• Tanks Diameter and height (Sim FB) 
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2.2.4.1 .2 Tank - Horizontal 

Based on the pipe connections to the vertical tank, 
the tank element will dynamically reflect the 
following: 

• Level in the tank - dynamic animation 

• Level at 100% or empty - color change 
Based on the process simulation, the following calculated parameters may be exposed: 

• Outlet temperature 

• Outlet composition 

• Liquid temperature 

• Simulated level 

The following may be configured for this element: 

• Number of input and output connections 

• Complete connections to the tank 

• Tanks Diameter and length (Sim FB) 



2.2.4.1.3 Heater 

Based on the pipe connections to the heate, the tank 
element will dynamically reflect the following: 

• Low heat transfer coefficient - color change 

Based on the process simulation, the following 
calculated parameters may be exposed: 

• Heat tranfer coefficient 

• Outlet product temperature 

• Inlet product temperature 

• Outlet pressure (assuming fixed drop) 
The following may be configured for this element: 

• Complete connections to the heater 

• Heater surface area (Sim FB) 

• Heat transfer coefTtcient when clean (Sim FB) 

2.2.4.1.4 Static Mixer 
1. xyz 

a. abc 
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2.2.4.1.5 Reactor 
2. xyz 

b. abc 




2.2.4.1.6 Mixer 
3. xyz 

c. abc 
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2.2.4.2 Custom Processing Element 

Many processing units such as distillation columns, evaporators, separators, boiler etc many be 
represented graphically as a processing element. The simulation associated with the vessel may be 
user defined if not included in our standard selection. Normally the processing will be described as 
the step response model relating each input to each output of the vessel. Inputs may be gas and/or 
liquid streams. Optionally, the user may define the equations that describe the relationships between 
the inputs and outputs of the processing element. 



To help users quickly create the static graphics associated with a custom processing element, some 
simple static graph representation will be provided that the user may select. If these simple graphics 
are used, then the user may specify the desired number of Input and output connects and the type of 
connection supported I.e. pipie, duct, or conveyor. In response, the graphic item will be displayed and 
can be Immediately used in the creation of the operator graphic 




The gains any dynamics associated with each input and output of the process element may be 
specified as show below if the user elects to specify the simulation algorithm as step responses: 













O Input 1 
• Input 2 
O Input 3 






Gain Deadtime Time Constant 


Bios 




Output 1 1.5 5 30 


16 


Output 2 0 0 0 
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If the user selects custom algorithm, them an expression editor similar to that used with the Calc/Logic 
block will be provided for the user to define the simulation algorithm. Based on the method selected, 
the properties of the custom processing element outputs may be calculated. 

By attaching transmitter elements to a custom processing element, the properties associated with the 
process element inputs or outputs may be referenced for off-line simulation. These properties may 
also be made visible in the display using an estimated property element. 
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Several pre-defined templates will be provided for custom processing elements. These templates will 
be described in this section. 



2.2.4.2.1 Boiler Template 

The following static graphic will be provided for the creation of a custom processing element that 
represents a boiler. As part of the template, a custom algorithm will be provide that will calculate the 
following process outputs: 

• Exit gas 02 

• Exit gas CO 

• Steam generated 

• Boiler drum level 

• Boiler draft 

The template will be based on a single fuel input. By modifying this template, it will possible to 
simulate boilers with multiple fuels. 
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2.2.4.2.2 Specialize Vessel --Cyclone Separator 



The cyclone separator may be used with in conjunction with the spay dryer custom processing 
element. A step response model may be used to define the expected response. 




2.2.4.2.3 Column 

The column custom processing element will utilize a step response model to define the expected 
process response. 




2.2.4.2.4 Specialize Vessel -Spray Dryer 

The spray dryer custom processing element will utilize a step response model to define the expected 
process response. 
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2.2.4,2.5 Specialize Vessel -Evaporator Body 



The evaporator custom processing element will use a custom model to define the expected process 
response. Based on the energy input and the concentration of the Input flow, the concentration of the 
outlet flow and vapor release will be calculated. Multiple evaporator elements may be connected 
together along with heat exchanger and eductor elements to create a multiple-effect evaporator. 




2.2.4.2.6 Specialize Vessel -Stack 

The stack custom processing element may be used with the boiler processing element. The 
properties of inlet are carried through the stack with no modifications. 
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2.3 Process Graphic Streams 

Stream elements may be included in a display to define the starting properties associated with a 
connection element. Also, stream elements may be used as connection points between displays. For 
such off-sheet connections between displays, the user may click on the stream to immediately call up 
the associated display that contains the referenced connection. 

2.3.1 Mass / Connposition 

The mass/composition stream element will normally be used for define 
the starting properties of a process input i.e. the starting feedstock 
composition, etc. or to define a link to a stream connection on another 
display. Connections may be made on the input or output of the 
mass/composition steam element (not both) 

The following may be configured for this element: 

• Name of the stream (unique within the DeltaV System) 

• Properties of the steam (if no reference input of input connection) 

o Mass fraction of component (if more than one) 

o Pressure or mass flow 

o Temperature 

o Specific heat 

o Density 

o Connection type (pipe, duct, conveyor) 

• Referenced Input sream( if used of accessing a stream on another display) 



2.3.2 Energy 

The energy stream element will normally be used for define the 
starting energy associated with a process input i.e. the BTU/HR 
transfer, etc. or to define a link to the energy properties of stream 
connection on another display. Connections may be made on the 
input or output of the energy stream element (not both) 

The following may be configured for this element: 

• Name of the stream (unique within the DellaV System) 

• Properties of the steam (If no reference input of input connection) 
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o Energy flow 

o Connection type (pipe, duct, conveyor) 
• Referenced Input sream( if used of accessing a stream on another display) 

2.4 Local Panels and Subsystems (Instructor Layer Only) 

In some process areas of a plant, a local panel will be installed to allow local start and stop of motors, 
to provide local indications of process conditions e.g. local temperature/level indicator, etc To allow 
this interface and any associated indications to be Included in the training system, a Local Panel 
graphic element may be associated with an actuator element. This graphic element for a local panel 
may be included in the Instmctor lay of the operator display. It Is envisioned that a set of local panel 
graphic elements will be created to address the different types of standard actuator elements. 
Some pieces of equipment such as compressors, generators, etc. may be purchased and supplied 
with instrumentation, specialized control, and in some cases local indications for temperature, level, 
etc Such subsystems may in some cases be interfaced to the DeltaV system through the senal 
interface card. ASI bus interface, etc. The associated process equipment and local controls and 
indications may be simulated using a custom process element. A custom process element may be 
created to represent the local panel interface to the control and indicators. This subsystem interface 
may be added to the instructor layer of the operator display. 

2.4.1 Standard Actuators 

The standard actuator elements that include a motor or on/off actuator will be designed include the 
capability to simulate the HOA function. A output indicating local operation will supported so this may 
be referenced by a Dl block that provides the Track input to the DC block. When the training 
instructor clicks on the graphic element for a standard actuator, then a standard faceplate will be 
presented that allows the instructor to select hand, off or auto as illustrated below. As an option, this 
faceplate may be docked and included in the display at an instructor station. 




2.4.2 Subsystems 

The local control logic associated with a subsystem may be included in the simulation function block 
algorithm associated with the process equipment. Since the inputs and outputs included on a local 
panel are specific to the subsystem and to the process equipment, a custom graphic element for the 
local panel may be constructed and included in the instructor layer of the operator display. An 
example of a custom graphic element for a local subsystem panel is shown below. 
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2.5 Process Modules / Simulations 

Process simulation function blocks will be provided for each element (see section 2.3) provided for the 
creation of a graphic display. Based on the elements contained in a display and their associated 
connection, these simulation function blocks will automatically be placed In a process module that will 
be used to simulate the process. The basis of the process simulation Is: 



simulation of the process will automatically be created using these simulation function block 

2.5.1 Actuator Elements 

The actuator element simulate will be based on the behavior of the mechanical device used for 
actuation. In the case of motors, the DC definition will be automatically utilized in the simulation. 
Dynamics associate with the actuator element will be limited to the stroking time associated with 
valve. 

2.5.2 Processing Elements 

The processing element simulation will be based on the defined inputs and outputs and 1) 
step response or 2) custom calculations based on simple energy and material balances. 
Thus, the properties that will be available for these blocks in most cases will be limited to: 

• Outlet temperature (based on inlet temperature, flow and heat capacity) 

• Outlet flow (based on inlet mass flow and accumulation within the element) 

• Outlet pressure (based on assumed drop across the unit) 

• Outlet composition (based on perfect mixing and inlet composition) 

When custom calculations are implemented, then the built-in dynamics associated with the 
outlet properties will added be based on 1^* order plus deadtime response to changes in the 
process inputs. The user may specify the deadtime and lag associated with each calculated 
property. 

2.5.3 Process Measurement Elements 

It will be assumed that the transmitter and switch introduce no dynamics In the referenced 
property. 

2.5.4 Connections 

It will be assumed that no dynamics are introduced by a connection i.e. the properties from 
the upstream connection are immediately reflected in the downstream connection. 
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2.6 High Fidelity Simulations 



2.6.1 General 

The I/O references that are defined for measurement and actuator elements will be used to 
automatically create the is used by HYSYS. Standard processing element templates will be defined 
for each HYSYS component that may be used to construct a high fidelity process simulation. When 
these templates are used with HYSYS. then the associated simulation function block in the process 
module act as shadow blocks i.e. their process simulation algorithm is not executed and the block 
parameters are read and written by HYSYS. 
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2.6.2 Operator Training 

The Instructor layer added to the operator display will provide instructor access to the nnanual 
actuators, and interfaces provided at local panels for actuators and subsystems. This capability will 
eliminate the requirement to implement separate instructor displays in training systems. Also, the 
dynamic simulation provided for the DC and DO blocks will eliminate the need to add low level logic to 
simulate the physical contacts provided by actuators and valves. Thus, the high fidelity simulation 
used for operator training could focus on the critical unit operations within the plant. 



2.7 Example Displays 

The following examples illustrate how the graphic elements defined in this document may be use to 
create graphic displays. 

2.7.1 Boiler Example 
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2.7.2 Column Example 




2.7.3 Custom Processing Example - Kamyr Digester 
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2.7.4 Evaporator Separator Example 




2.7.5 Mixer Heater Example 
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2.7.6 Reactor Example 
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3 Concept 



This section discusses the design of Process Graphic Displays and process modules. Also, 
information will be provided on how a process module for may be automatically created from a 
graphic display or manually constructed in control studio.. Details are provided graph elements and 
simulation function blocks used to create displays and simulation modules. Also, infonmation is 
provided on how high fidelity process simulation packages, such as HYSYS, may be linked Into 
DeltaV displays and control using the process modules. 



3.1 Overview 

At the Process Graphic level we have a view that is very similar to what is available with iFIX today. 
At this level the user selects Process Graphic elements such as Valve. Pump, Tank. Heater, Mixer, 
etc drops them on a Process Graphic and then connects them together using piping. The user adds 
animations, dynamic values, etc to control, measurements or actuators as they would with iFIX. 

The user can also select the Process Graphic Display and enable process simulation. The dynamic 
simulation yfAW be constructed from simulation function blocks that are based on simple composition 
calculations , mass balance, energy balance and custom calculations. 

If high fidelity process simulation is required, then a simulation package such as HYSYS may be 
linked into Detia through process modules. In this manner, information from the process simulation 
may be made available on the Process Graphic Display. 

A Process Module may be automatically generated from a process graphics. The functionality 
available to the Process Module is determined by the Process Graphic elements. What should be 
clear is that the Process Module will be constructed to shadow the Process Graphic Display. 

yVhen the user configures their Process Graphic Display they have the ability to include additional 
information such as Mass or Energy Streams. These streams are used in the process module to 
establish starting conditions needed by the simulation function blocks. 

Since Process Modules are real DeltaV Modules, it is also possible for them to reference, and be 
referenced by, DeltaV parameters, control strategies, displays, etc as illustrated below. Also, using 
this capability, it is possible for a process module to be created in DeltaV Control Studio independent 
of the Process Graphic Display. 
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3.1.1 Display Layers - Off-line Simulation 

The process simulation may be designed to include hand valves and local panel inputs that will exist 
in the plant but are not wired into the DeltaV control. Traditional operator training systems(OTS) have 
traditionally included custom built instructor graphic displays that included graphic elements to 
represent and provide access to these local component. To avoid the need for separate instructor 
displays, the operator graphic will be designed to support layers of information that may be visible or 
not visible depending on the user and whether the display is being used for off-line simulation or on- 
line operation. In particular, it will be possible for the user to add an Instructor layer to any operator 
graphic. Through this instructor layer, it will be possible to add manual valves and other graphic 
elements that represent and provide access to the simulation of local valves, local panel input, and 
disturbance inputs to the process simulation. For example, the operator graphic for on-line operations 
might appear as shov^ below. 




In the off-line environment, the display would automatically display manual valves and local panel 
inputs if the a user at the associated station has "Instructor" privilege. This added layer of 
information would be show with the other information normally presented to the operator as shown 
below. 
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If the Instructor clicks on the manual valve or local pane! graphic element, then a faceplate will be 
presented from which the Instructor may make changes e.g. open close manual valve, etc. 

AJso, in the off-line simulation, the instructor layer will also add behavior to the I/O elements i.e. 
transmitter, motors, damper or valve element included In the display. In response to the instructor 
clicking on one of these graphic elements, a faceplate will be presented to the Instructor that allows 
him to enter disturbances into the process simulation. For example, the faceplate provided for a 
transmitter would allow the instructor to do one of the following: 

• Bias the measurement value 

• Add noise to the measurement 

• Enter a fixed value for the measurement value 

• Change the measurement status from Good, Bad or Uncertain. 

The faceplate selections associated with a motorized value or motor would allow the instructor to fall 
the motor run feedback, torque limit switch, etc i.e. force not running when the setpoint and 
associated discrete outputs of the DC block are set to run state. 



3.2 Process Graphic Display 

In the graphic display editor, a number of display pallets to support the creation of graphic displays. 
The following standard palettes provided in OeltaV: 

• Calculation and Control - elements to access information from function blocks used in control 
and calculation e.g. PID function block SP, PV, OUT 

• Properties and Measurement- elements used to access or specify field measurements and 
simulated properties associated with connections or process equipment i.e. field 
measurement, simulated values. 

• Actuators — elements representing field devices used to set or regulate process streams 

• Processing - elements representing common process equipment. 

• Custom - elements that allow equipment that is specific to a manufacturing process to be 
represented in the graphic display. 

As in Control Studio, the user may create his own palette from items included in these standard 
palettes. All the elements included in the display except for Steam and Connection elements may 
be modified by the end user to satisfy his display requirement. 



3.2.1 Calculation and Control 

The elements provided to access function block parameters in control modules will be similar to the 
module and faceplate dynamo's currently provided In Ifix. However, an interactive editor will be 
provided to make it easier to create or modify the values displayed, associated faceplates and details 
displays. These elements will reference function block parameters in control modules I.e. no 
reference is made to the process control module. 



3.2.2 Properties and Measurement 
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The measurement and switch elements may be attached to a connection or processing element to 
show Its associated properties. In the graphic, these will appear similar to the dynamo's, faceplated. 
and detail display provided in ifix to access measurement values. These elements will reference the 
associated Al or Dl function block. Also, as part of the element configuration, a reference to a 
property of a processing element or connection can be define. This reference will be used by the 
associated process module to write this property value to the SIMULATEJN or SIMULATEJN_D 
parameter of the associated Al or Dl function blocks. Thus, when simulation is enabled in the Al or Dt 
function block, the simulated value will be used by the function block in place of the measurement. 
Also, if this reference is configured, then other simulated properties of the valve may be displayed with 
the valve or used to change color, etc associated with the valve. 

The estimated property element will appear In a display similar to measurement elements. However, 
these elements will reference the simulation function block parameters contained in a Process 
Module. 



3.2.3 Actuator Elements 



A wide variety of standard actuators will be provided for creation of a display. The graphic 
representation will reflect the type of actuator When an actuator element is selected in the display, 
then a faceplate and detail display provided in ifix to access output blocks. These actuator elements 
will reference an AO. DO and DC function blocks. Also a reference to a simulation function block 
may be configured for this element. This reference will be used by the actuator element to display 
simulated properties of the actuator or used to change actuator color, etc. Also, based on this 
reference, parameter of the function block will be provided to the simulation function block. 



The customer may modify the static view associate with actuator element to give these a custom 
appearance. Also, this element will have configurable options to change colors based on the actuator 
properties 



3.2.4 Processing Elements 

A standard set of processing elements will be provided for common application in the process industry 
e.g. storage tank. Also, custom process elements will be provide to address application that are 
unique to a manufacturing process. All process elements and their associated simulation function 
block will share a common structure. 

The visual appearance process element in a graphic display is defined by its connections and static 
view. To define a new processing element, the user will need to specify the number of input and 
output connections, their relative location and type (pipe. duct, or conveyor) assigned to each 
connection. This could be done by the user assigning connection items to a basic frame and then 
specifies one or more static view that will be associated with the graphic representation, as illustrated 
below: 




Define connections. One or more static view 

location on frame 
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The static view that is show at any given time may be specified by the user based on a referenced 
parameter of a function block or a simulation function block. In addition, the capability will be provide 
to include dymanic elements (values, strings, bars, etc) within the processing element. 



3.3 Process Module 

The process modules will consist of simulation function blocks, streams, and their associated 
connections. Since there is a one to one correspondence between the process graphics elements 
and simulation function blocks, It will be possible for a customer to construct a graphic display and to 
automatically generate the corresponding process module, as illustrated below. 
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Process Module automatically created 
from the process graphic display 



To allow this automatic generation of the process module, it will be necessary for the customer to 
identify the actuator, connection or processing element property associated with measurement 
element and estimated property elements. 

A customer may need to create a process simulation before process graphics or, in some cased, 
before the control module are constructed. Thus, the process module type will be supported in 
control studio. When this type is selected, then the simulation function block palette will be provided 
to constmct a process simulation. After the simulation is constructed, it will be possible to fill in the 
references to the I/O blocks in the control module. Also, when the associated graphic display is 
created, it will be possible to browse to the existing process module to set the property references. 
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Process graphic constructed after the 
process module and control modules 
have been created automatically 
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In some cases the process graphic may not contain all the detail needed to construct the process 
simulation. Thus, it is important that the capability be provided to edit and simulation module that 
have been automatically created from a process graphic. Also, since multiple process graphics may 
need to display the same piece of equipment, it is necessary in the construction of a process graphic 
for an element to reference an existing process module. 




Properties calculated by a process modules may be included in multiple process graphics 



3.3.1 Simulation Blocks 

The simulation function blocks that correspond to the processing elements will have a common 
structure. These block are characterize by the following features: 

• The block Input connections and the parameters of the block are used in the simulation i.e. 
no reference to control module is supported. 

• The number of inputs and outputs connections supported by the block may be defined as 
extensible 

• Results from the block executing may be reflected In the block output connections or as 
parameters of the block, 

• The block algorithm may be defined as a step response or may be entered by the user similar 
to the Calc/Logic block. When the algorithm Is entered then the user may Independently 
specify the dynamic for each output. 

• Local panel or subsystem inputs or logic that is directly associated with a processing element 
may be included in the block algorithm. 

• A common set of parameters will be supported for Input and output connection. 



3.3.1 .1 Input and Output Connections 

The parameters associated with input and output connections will be communicated between blocks 
as an array parameter or structure consisting of the following parameters. 

1 . Connection (Good/Bad) 

2. Mass Flow 

3. Pressure 

4. Temperature 
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5. Specific IHeat 



6. Density 

In Sonne cases, other parameters such as composition of a steam is required in the function blocl< 
algorithm. To support this requirement, a standard and extended Stream block will be provided. As 
part of the extended stream blocic configuration, the user may select a set of pre-defined groups of 
data. These extended connections will be allowed to connect to block that utilize this information. In 
general, the extended parameters set will consist of the following: 

7. Group Name 

8. Element 1 

9. Element 2 

10. Elements 

11. Element 4 

12. Elements 



One of the pre-defined group sets may be the fuel input to the function block associated with the 
boiler processing element. For this example, the group would contain the component of the fuel. 

7. Fuel Set 

8. Carbon, wt % 

9. Hydrogen in fuel, wt% 

10. Sulfur in fuel, wt % 

11. Oxygen in fuel, wt % 

12. Moisture in fuel, wt% 

13. Nitrogen in fuel, wt % 

For a turbogenerator processing element, the connections to the associated simulation block may use 
an extended parameter set that includes: 

7. Steam Set 

8. Steam Enthalpy (Actual entering the stage 

9. Steam Enthalpy ( Actual) exiting the stage 

10. Steam Enthalpy (If isentropic expansion) 

The expanded group set will also be used when simulation blocks are used as an interface to high 
fidelity simulation packages where on some streams the composition is to be visible in the process 
graphic. 



3.3.1.2 DeltaV References 



When a measurement or actuator element is added to a process graphic, the user may browse to 
select the associated I/O block in a DeltaV Control module. During off-line operation, the calculated 
measurement or measured position from the simulation will be automatically written to the 
SImuiateJN parameter in the associated input and output function block. . 
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During on-line operation, the measurement value may be utilized in the process simulation. The 
associated parameter may be compared to the simulated value and used to alert the operator to a 
difference in these values. When a transmitter measurement or actuator feedback element is 
detected as failed, then the operator may elect to use a simulated value. This simulated value will be 
through the Simulate_IN parameter of the associated block(s). In this section, we address the inputs 
that may be provided to function blocks in a Control module. 



3.3.1.2.1 Transmitters 



The field measurement value will normally be displayed by the transmitter element In the operator 
graphic. However, during operator training, the SIMULATE parameter of the associated Al In a 
control module will be set to Enable so that the simulated value may be used in the operator display 
and the associated control module. During normal process operation, the field measurement value 
will normally be displayed and used in the control module. If the associated transmitter fails, then the 
operator may elect to use the simulated value in the display and in the control. Also, the measured 
value will normally be used in the process simulation and automatically display and compared to the 
simulated value to the measured value, as illustrated below. 
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3.3.1.2.2 Switch Inputs 

The field swtch input will normally be displayed by the switch grahic element in the operator graphic. 
However, during operator training, the SIMULATE parameter of the associated Dl block in the control 
module will be set to Enable so that the simulated value may be used in the operator display and the 
associated control module. During normal process operation, the field measurement value v^ll 
normally be displayed and used in the control module. If the associated transmitter fails, then the 
operator may elect to use the simulated value in the display and in the control. Also, the measured 
value will normally be used in the process simulation and automatically display and compared to the 
simulated value to the measured value, as illustrated below. 
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3.3. 1 .2 .3 Regulating Valve 

The measured stem position (for FF device) or the implied position of regulating valve will normally be 
displayed with the valve in the operator graphic. However, during operator training, the SIMULATE 
parameter may be Enabled so that the simulated value position may be used in the operator display 
and the associated control module. Through this simulation, it is possible to demonstrate the impact 
of valve stiction during maintenance and operator training, as illustrated below. 
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3.3.1.2.4 On-Off Valve 

The limit switch feedback or the implied position of an On-Off valve will normally be displayed with the 
valve in the operator graphic. However, during operator training, the SIMULATE_D parameter may 
be Enabled so that the simulated On-Off position may be used in the operator display and the 
associated control module. Through this simulation, it is possible to demonstrate the impact of valve 
or actuator failure during maintenance and operator training, as illustrated below. 
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3.3.1 .2.5 Pump(wlth Motor - fixed or multi-3peed) 

The device control block may be used to provide the start/stop discrete outputs and discrete feedback 
firom a pump motor actuator. The PV of the DC function block used for motor control may be shown 
in the graphic display to indicate the true status of the motor. However, during operator training or 
control checkout, the SIMULATE_D parameter may be Enabled so that the simulated On<Off status of 
the motor starter may be shown in the operator graphics and used in the DC function block. Through 
this simulation, it is possible to demonstrate the impact of a motor failure during maintenance and 
operator training, as illustrated below. 
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4 Scenario 



4.1 Overview 

This scenario Is intended to illustrate the principles of the use of the combination of Process Graphics 
and Process Modules. In this scenario a plant has a number of heat exchanger units that are used to 
make Vinegar. Each Unit mixes a specified quantity of acid, base and water to produce a variety of 
vinegar. Each heat exchanger unit has as a feed acid, base, and water. Each heat exchanger has an 
outlet that goes to a product tank and a second outlet that recycles cooling water. The overall 
process is illustrated below. 
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Figure 1. Vinegar Production 



Each Unit has its own control strategy, process graphic, and process module. The scenario describes 
the development of a Process Graphic and a Process Module. The Process Graphic and Process 
Module can be used to provide Simulation capabilities for Control. Operator Training, etc. 

To make the scenario easier to follow a possible control strategy is shown below. The drawing 
presents the control strategy from a Module Class point of view. 
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Figure 2. Vinegar Control Strategy 



The Class-based hierarchy for the above drawing is shown below. 
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[Phase Class] 
[Phase Class] 
[Phase Class] 
[Phase Class] 

[Equipment Class "STATIC_MIXER"] 

[Module Class "FLOW_LOOPT 
[Module Class "FLOW_LOOPT 
[Module Class "FLOW^LOOPT 

[Equipment Class "HEAT_EXCHANGERT 
[Module Class "FLOW^LOOPT 
[Module Class "ON^OFF^VALVET 
[Module Class "ON_OFF VALVET 

[Module Class "PH^CONTROL"] 



4.2 Process Graphic and Process Module Design 
4.2.1 Process Graphic 

This section discusses the design of Process Graphic Displays and Process Modules. To lilustrate 
these ideas a Process Graphic Display is Implemented covering a heat exchanger used for making 
vinegar. 

The User creates their Process Graphic Display as much as they do with iFIX today. Essentially they 
create a Process Graphic Display and build it up using Process Graphic Items, Piping, etc. 

The Process Graphic Display used in this scenario includes several ... 
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Figure 3. Process Graphic Display 



4.2.2 Thumbnail View of the Process Graphic 

Process Graphic Display that are created "Class-based" have a built-in capability - they can be 
collapsed (very much like composites when they are embedded in other displays). This Is illustrated 
below for the Vinegar process. 




Figure 4. Process Grapliic Display Composite 



Displays can then be combined to create a large navigational display. This Is shown for the overall 
Vinegar example described In this scenario. 
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Figure 5. Overview Process Grapliic Displays 
These overview displays can then be used for navigation. 

4.2.3 Process Module 

4.2.3.1 Process IVIodule View 
The Process Module View includes... 
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Figure 6. Process Module Display 
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4.2.3.2 Energy Balance 



4.2.3.3 Mass Balance 



4.2.3.4 Simple Composition 



4.2.3.5 Custom Composition 



4.3 Process Simulation Using HYSYS 

The Process Simulation Blocks described above can be given high fidelity behavior by tying them into 
a simulation packages such as HYSYS from Hyprotech. The following part of the scenario substitutes 
HSYS in to provide behavior on the Simulation Function Blocks. 



4.3.1 Dynannic Simulation 

When the user creates their Process Module they are able to specify that a High Fidelity Simulation 
will be used. When they do this the built-in behaviors in the Process Module will be disabled. In this 
case the Process Module acts as a 'composite' to marshal parameters to/from the High Fidelity 
Simulation System. 

In the scenario that Is being described here the Acetic Acid process Is reproduced In HYSYS. The 
simulation is shown below. 
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Figure 7, Acetic Acid High Fidelity Simulation 
The inputs and outputs for this simulation are shown in the attached figure. 
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Figure 8 High Fidelity Simulation Import/Export Mappings 
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1 Introduction 



The implementation of process simulation is a significant part of the project. Many of the basic 
concepts associated with the creation of simulation based on the operator graphic display have been 
defined in the Starbum concept document. Also, this concept document defined the process module 
as the container for process element used to construct the simulation. Some of the most common 
components, such as stream elements, process elements that simulate actuators, and processing 
units for vessels such as tanks are defined. The purpose of this document is to document the 
difference approaches that can be taken in the implementation of process simulation. Also, an 
approach for the DeltaV simulation implementation is presented and details provided on some basic 
stream components and process vessel. In the first two sections, some background is provided on 
process simulation and traditional approaches in implementation. The later sections focus on the 
implementation approach that will be taken in the DeltaV Process Module. 

1.1 Background - Fluid and Gas Flow Simulation 

Pressure is driving force for liquids or gas transfer between vessels. The flow through a transfer pipe 
or duct is based on the starting pressure and the pressure drops introduced by the processing 
elements In the flow path e.g. pipe, valves and the point of discharge. To illustrate this, in this section 
we will consider three typical examples that will be encountered in process simulation 

1.1.1 Specified Starting Pressure 

In some cases, the upstream equipment may not be Included in the simulation and the user may 
specify the starting pressure as part of the stream properties when pressure is defined as the 
independent parameter. When steam pressure (starting pressure) is specified, then the flow through 
the associated pipe is determined the pressure drop introduced by the pipe and the elements In the 
pipe and the pressure at the point of discharge into a tank, as illustrated below. 




Starting 
Pressure 



Regulating 

Valve 

Drop 



Blocking 

Valve 

Drop 



Pipe 
drop 



Tank 



Tank 
Pressure 



System Pressure Drop 
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The calculation of the pipe flow is complicated by the fact that the pressure drop introduced by the 
pipe and processing elements in the pipe is a function of flow rate. Also, for regulation and on-off 
elements, a variable pressure drop is introduced based on the actuator position. Assuming the tank 
pressure may vary i.e. closed pressurized tank, then variation of pipe flow as a function of tank 
pressure, actuator position and characteristics can be illustrated as below. 




Line Flow 

Pipe Flow as a Function of System Pressure Drop and Available Pressure 



1 .1 .2 Vessel Establishes Starting Pressure 



if a vessel is pressurized, then this pressure may be used as the driving force for transfer of vapor to 
liquids between tanks or from a tank to a vent, header, etc. 



Pressure reducing 
Valve (PRV) 




Regulating 
Valve Drop 



Blocking 
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For this example, the driving force for steam flow is the differential pressure between the high and low 
steam header. Since the pressure in each header, then the differential pressure is variable. The pipe 
flow thus is determined by this differential pressure, the position of the regulating and on-off valve, 
and line loss. This relationship is similar to that previously illustrated for the case where the starting 
pressure was specified. 



1 .1 .3 Pump or Fan Establishes Starting Pressure 
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A pump or fan is often the pressure source that provides the driving force for liquid or gas flow 
respectively. In such cases, the pressure provide will be a function of the flow. This relationship may 
be documented by the equipment manufacturer by a pump or fan curve that shows the expected 
pump differential pressure as a function of pump flow. The following variable speed pump example 
may be used to illustrate the impact of pump discharge pressure with flow rate. In this example, the 
liquid supply to the pump is assumed to be from a tank at constant (atmospheric) pressure. In this 
example, pump discharge flow travels through a pipe to a heat exchanger before entering another 
tank (at atmospheric pressure) as illustrated below. 




Tank 



Assuming the downstream tank pressure is constant i.e. open tank, then variation of pipe flow as a 
function of pump speed, actuator position and characteristics and pipe pressure loss can be illustrated 
as below. 




At a given pump speed, a flow will be established at which the discharge pressure matches the 
system pressure loss. Since the system pressure loss is a function of the flow rate, then a point of 
equilibrium may be established. The flow will change with any variation in system pressure loss, 
downstream tank pressure or changes in pump suction pressure. 



2 Techniques for Simulation 

Various approaches may be taken In process simulation. In this section we review traditional 
techniques that have been successfully used to Implement low fidelity and medium to high fidelity 
process simulation. 
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2.1 Low Fidelity Process Simulation 

If a process simulation is to capture the true interdependence of pressure and flow in a stream, then 
the solution In non-trivial. Thus, in many cases low fidelity process simulation packages have been 
implemented for operator training system and for control or graphics checkout. These low fidelity 
process simulation systems do not attempt to model all the process behavior. For example, the flow 
in a pipe may be determined strictly by the position of the regulating actuator in the pipe. The impact 
of upstream or downstream pressure, pressure losses through the pipe loss, blocking valves, or inline 
elements such as heat exchangers are often totatiy ignored. Thus, for the calculation of stream flow, 
the process design may be simplified for as follows for a low fidelity simulation. 



For example, the flow associated with a variable speed pump may be assumed to be linear with pump 
speed - allowing the flow to be calculated simply as: 

Stream Flow = (% Pump Speed/100) * K 

Where K is a constants based on the EU range of an associated flow transmitter 



Though such an approach leads to a simulation that is quick and easy to implement, this 
implementation has the following disadvantages in actual practice. 

• The pressures in vessels connected by a stream have no impact on the calculated stream 
flow and pressure. For example, a flow may be calculated even thought the pressure driving 
force is zero. 

• Processing elements in the stream have not impact on the calculated pressure and flow. 
Thus, a flow may be calculated even when block valve(s) upstream or downstream of the 
regulating valve or pump are closed. 

• Characteristics of the regulating elements and the variations in system loss with flow are not 
reflected in the simulation. Thus, the calculated stream flows pressure at different points 
along the stream may have significant error. 



To address some of these short comings, the vendor of low fidelity process simulation packages allow 
the user to introduced heuristics based on the specific processing element and vessels associated 
with the stream. For example, to account for the fact that a block valve is upstream of a regulating 
valve, the user would have to add logic that does the equivalent of the following: 



If (Block Valve HC101) =: Closed Then 




Calculated Flow = 0 



Endif 
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The addition of such heuristics to account for these conditions are avoided in many medium and high 
fidelity process simulation by accurately modeling the stream pressure source, the impact of each 
element in the process stream and the downstream vessel pressure. Also, since these components 
are accounted for in simulation, then the stream flow and pressure conditions along the may be more 
precisely calculated over a wide range of operating conditions. Thus, it is proposed that the stream 
modeling capability provided by the DettaV process module and processing elements be designed to 
allow the Impact of each element in the stream to be accurately modeled. 



2.2 Medium and High Fidelity IModeiing Teclinique 

Commercial products that support complete dynamic process simulation are typically based on one of 
two basic approaches: 



Sequential-Modular Simulation - Classical approach is utilized in the majority of simulation 
tools on the market today 



Open Equation Simulation - Latest approach that is promoted by some vendors for 
simulation of larger processes. 



Using either approach, there is a need to tune model parameters to reflect the actual operational 
behavior. In this section, we compare these approaches and techniques for model adjustment and 
data reconciliation. 

2.2. 1 Sequential-Modular Simulation 

With this approach, each piece of equipment/unit is represented as a "module" that is characterized 
by input/output connections and a contained algorithm. Each equipment/unit module Is solved one 
after another, sequentially. Because of the interactions between modules, the sequential model 
requires several iterations In each simulation step in order to achieve convergence. To speed 
convergence, some products are structured for simultaneous solved pressure flow networks, with 
the remainder of the model solved in a sequential-modular fashion. 

To utilize the sequential-modular approach when the process is characterized by interactions such as 
flow pressure within a stream, the concept of "tearing" connections to modules may be introduced. An 
Initial guess is provided for values that are unknown (the tear variables) and then calculate the value 
of the tear variables from the modules. These calculated values may be used to determine new 
guesses that are applied in a interactive manner until the difference between the estimated and 
calculated values are sufficiently small. This process can be represented in the following manner 
(reference: Edgar. Optimization in Large-Scale Plant Design and Operations): 
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One of the strengths of the sequential -modular approach Is that the representation of each piece of 
equipment can be standardized and combined in a variety of ways to simulate different equipment 
configurations. 

2.2.2 Open Equation /Simultaneous Simulation 

This latest technique is based on simultaneous, equation based solutions technology. The 
differential and algebraic equations from all the contained model objects are treated as a single large 
set of equations. These equations are solved simultaneously. This general approach applies to all 
kinds of simulation and can be conceptually represented as follows. 




A good deal of complexity is introduced by this approach to successfully address the different 
combinations of process elements and associated discontinuities. 



The EU-sponsored CAPE-OPEN committee is defining interface standard for process simulation 
toots. The current specification requires the modeler to provide access to the equation structure and 
initial values. Such information allows an open equation approach is simulation implementation. 
However, addressing discontinuities, such as on-off valves, in such an environment is a significant 
challenge and has limited the success of products following this standard. 



2.2.3 Parameter Estimation and Data Reconciliation 

During model creation, a number of parameters may be specified that characterize the equipment 
design and capability e.g. heat-exchanger coefficients, etc. Since the actual equipment performance 
may not match that assumed in the design, it is necessary to tune these parameters to make the 
model match the actual process. In some cases, the process simulation supplier offers tools to allow 
this to be done on-line. For example, the ABB Dynamic Solutions package offers a "parameter 
estimation capability. Uncertain or unmeasured parameters can automatically be estimated from 
operational data. The estimated parameters are optimal in the sense that they minimize the quadratic 
cost of model mismatch from actual behavior. In this way, the process model can be kept updated to 
reflect the plant operation. 
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To account for measurement drift and measurement error or fault, many simulation packages 
incorporate an ability to do data reconciliation. For example, the ABB Dynamic Solutions, the process 
model is used to correct measurements are "cleaned" for gross errors and then the model is used to 
calculate bias values for measurement values to "punish inconsistencies as well as corrections". This 
technique is also used to rectify material and energy balances and to provide lead detection 
capability. 



2.3 Stream and Element Properties 



The standard properties that are required for liquid, gas, and solids connections In the forward path 
are: 

1) Mass-flow 

2) Temperature 

3) Pressure 

4) Density 

5) Specific Heat. 

These properties are required to do the energy-material balances associated with a process element 
or vessel such as a tank or mixer. 

For example, the tank algorithm would calculate the level based on the Inputs connection mass-flow, 
outlet connections mass-flow, inlet density (to convert mass flow to volume) and factors that 
characterize the physical shape of the tank I.e. liters/meter, height of tank. Based on the level of the 
tank, the outlet connection pressure would be calculated based on overhead tank pressure (If 
pressurized) and the outlet connection points In the tank, and the level plus density (to determine 
liquid head). SImilariy, the outlet connection temperature will be calculated based on the Inlet 
connection temperatures, mass flow and specific heat, tanks level (and specific heat and density). 

In this section we address the units associated with a stream or element property. Also, ability to 
associate composition with each Independent steam is defined along with the rule for propagation of 
composition through processing elements and vessels. 

2.3.1 Parameter Engineering Units 

All properties associated with a connection, processing element or vessel are required to be in the SI 
units. The standard properties will always be internally calculated and exchanged between vessels 
as streams in metric units - Based on the International System of Units (SI) and SI Derived Units that 
are commonly used in specialized fields such as process measurement and control . This selection of 
units is based on Federal Standard 376B, Preferred Metric Units for General Use by the Federal 
Government: 



Parameter 


Unit Name 


Unit Symbol 


Express in 
other SI Units 


Mass-flow 


kilogram per second 


kg/s 




Temperature 


degree Celsius 


»C 


K 


Pressure 


kilopascal 


kPa 


N/m^ 


Density 


kilogram per cubic meter 


kg/m^ 




Specific Heat 


kiiojoule per kilogram kelvin 


kJ/(kgK) 





Other contained or internal properties may be associated with vessels or processing elements. The 
following units should be used for visible or internal properties: 
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Parameter 


Unit Name 


Unit Symbol 


Express In 
other SI Units 


Length 


meter 


m 




Area 


square meter 


2 

m 




Volume 


cubic meter 


m^ 






liter 


L 


m 


Time 


second 


s 




Velocity 


meter per second 


m/s 




Acceleration 


meter per second 
squared 


m/s^ 




Flow rate 


cubic meters per 
secona 


m'/s 






litarc oar eaf^onH 




m §9 




miilina^cal <SAcnnri 
■ 1 iiiii^aswai oowwi lu 


iTI"ei*5 




Force 


newton 


N 


9 1 If 9 


Energy 


kilojoule 


kJ 


Nm 


Power 


kilowatt 


kW 


Nm/s 


Thermal conductivity 


watt per meter kelvin 


W/(mK) 




Coefficient of heat transfer 


watt per square meter 


W/(m^.K 





The following common metric prefixes may be attached to the 81 unit name to form multiples of the SI 
unit. 



Prefix Name 


Prefix Symbol 


Multiplip^tion factor 


kilo 


k 


10^ 



The user may select whether to enter and see process block parameters in metric units or Inch-pound 
units. Based on this selection, the following will occur: 

• The default parameters of function blocks will be set to either Metric or Inch-pound units 

• The process function block calculation will take Into account the SI or inch-pound unit 
selection 

The set of default parameter values and internal process block calculations will be based on the 
following multiplication factor used to convert from Inch-pound units to Metric. 



Measure 


To Convert From 


To 


Multiply By 


Mass-flow 


Pounds per second 


kilogram per second 


0.45359237 


Temperature 


degrees Fahrenheit 


degree Celsius 


(tF-32)/1 .8 


Pressure 


Pound-force per square inch 


kllopascal 


6.894757 


Density 


Pounds per cubic foot 


kilogram per cubic meter 


16.01846 


Specific Heat 


Btu per pound degree 
Fahrenheit 


kilojoule per kilogram Kelvin * 


4.1868 
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Length 


foot 


meter 


0.3048 


Area 


square foot 


square meter 


0.09290304 


Volume 


Cubic foot 


cubic meter 


0.02831685 




gallon 


liter 


3.785412 


Time 


second 


second 


1 


Velocity 


Foot per second 


. meter per second 


0.3048 


Acceleration 


Foot per second squared 


meter per second squared 


0.3048 


Flow rate 


Cubic foot per second 


Cubic meters per second 


0.02831685 




Gallon per second 


Liters per second 


3.785412 


Vlscosity(dynamlc} 


centipoise 


mlllipascal second 


1 


Force 


Pound-force 


newton 


4,448222 


Energy 


Btu 


kilojoule 


1.055056 


Power 


Btu per second 


kllowett 


1 055056 


Thermal conductivity 


Btu inch per hour square foot 
degree Fahrenheit 


watt per meter Kelvin* 


0.1442279 


Coefficient of heat 
transfer 


Btu per hour square foot 
degree Fahrenheit 


watt per square meter Kelvin* 


5.678263 



• Defined in terms of temperature interval. Therefore K may be replaced by '•C. 



2.3.2 Stream Composition 

The specification of stream composition is optional in the process simulation i.e. may not be 
used/specified. Therefore, the user should be able to specify the connection type (gas, liquid, solid, 
energy) Independent of the composition (air, water, fuel oil, etc). For energy connection types (i.e. 
current flow through a wire) there is no associated composition. All streams, processing elements, 
and standard vessels will be designed to process streams which have composition defined. 
Composition will be defined In terms of the mass faction represented by each possible path 
component 

The elements In a stream such as a valve, pipe, pump will have no impact on the stream composition 
i.e. the inlet and outlet composition are the same. Those elements that mix multiple inlet streams will 
use/change composition I.e. header or vessel. For these types of elements, the outlet stream may in 
general contain some concentration of the components that are associated with each inlet 
connections plus new components (If reaction occurs). Thus, when composition Is defined for 
connections, then the same composition is always used for upstream and downstream connections to 
the element. In general, the same composition may be used for all elements in the same 
"independent stream path". 

For example, in a boiler application, there are two "independent paths" through the process where a 
consistent composition should be defined/used by all elements In the path 1 ) water/steam path and 
2)fuel and air/flue gas path. The water flowing through the feed water tank, deairator and steam in 
the drum, desuperheater, and steam header would all use the water/steam composition. Since 
the natural gas, oil. coal streams mix with the air flow stream to produce stack gas, then the same 
composition would apply to the fuel, air, and stack gas streams. 

When a user defines a stream, he may elect to define the composition. When he chooses this option, 
then it will be necessary for him to define the stream composition by first identifying all the possible 
chemical elements that may be present in this stream as it is processed and mixed in the downstream 
equipment associated with the stream. Then he may define the composition of the stream In terms of 
the mass fraction of the elements that are present. In general, the composition would be defined as 
follows: 
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Composition Name 



Possible Components 


IVIass Fraction 


Component 1 


0 


Component 2 


0 


Component 3 


0.2 


Component 4 


0.2 


o 




o 




Component N 


0.6 



At any point in the processing of the stream, the sum of the mass fraction of the component in the 
stream may add up to one. The density property of the stream will be automatically calculated based 

on the stream composition. 

In defining the stream composition, the user may select a predefined composition e.g. fuel or create a 
composition by defining components that may be present In the stream as It Is processed. If 
components will be present that are not defined in the standard list component, then the ability is 
provided for the user to add components by defining: 



• Component name 

• Density 

• Heat capacity 

In a few cases, a processing element may be associated with more than one "independent path". For 
example, a heat exchanger has two stream inputs ( steam, liquid stream ) but these do not mix in the 
exchange. Thus, the composition on the steam input connection and condensate out connection 
would be the same composition i.e. are in the same "path", as illustrated below. 




A processing element may be associated with more than one "independent path" 

The composition of the exchanger liquid input connection and outlet connection may be the same but 
could be different than the steam path composition. Elements with multiple inputs in which mixing 
occurs e.g. tank, reactor, column, etc should require that the same composition (if defined) be used 
on all inputs and outputs since all inputs to this element are by definition in the same processing 
"path" as the outlet connections. 

Based on this concept of "independent paths" through a process, we can enforce/require that ttie 
same composition (if specified by the user) be used for all elements associated with each 
"independent path" through the process. In some cases, there may be two or three "independent 
paths" through a process. If separate, distinct processing is done in different plant areas e.g. water 
treatment and pulping, then it may be necessary to define a composition for each area of the plant In 
most cases the user will need to define two or three composition definition and these will be sufficient 
to address the entire plant simulation. 
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The stream composition and density property will be automatically propagate by steam elements that 
have a single Input. However, any vessel with two or more input streams that are mixed in the vessel 
may calculate the resulting composition and associated density of the vessel outlet streams. For a 
simple tank Is which the streams do not react, then the outlet composition may be calculated based 
on the Inventory in the tank and the Inlet stream flows along with the composition associated with 
inventory and streams. 

The standard process blocks that will be provided for vessel simulation will assume that no reaction 
occurs in the vessel. The user may define a custom process block in which he takes into account 
reactions that may occur within the vessel. In these cases, the reaction kenetics will be defined in the 
algorithm Implemented by the user. 
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3 Simulation Using DeltaV Process iVIodules 



The accurate calculation of the flows into and out of process vessels is the basis of the energy and 
material balances that may be done to calculate the vessel properties such as temperature, 
composition, and pressure. Often the dynamics associated with stream processing i.e. actuators and 
processing elements included in a pipe, duct or conveyor are much faster than those associated 
with processing vesse/s. For the simulation to be done Is DeltaV, a sequential modular approach 
will be implemented based on taking advantage of this difference in dynamics. Specifically, for the 
purpose of dynamic simulation, the conditions associated with processing vessels may be assumed 
constant for during the multiple iterations of stream processing simulation in which the flow and 
pressure is established between vessels, as illustrated below. Similarly, the processing associated 
with process vessels may be done assuming that the inlet and outlet flows to the vessel are constant 
for each iteration of the simulation. 




Multiple iterations to 
resolve pressure-flow 

Such an approach allows the simulation of steams and processing units to be divided Into smaller 
units that are decoupled through this "tearing" in connections. 

Each element in the stream will calculate its outlet pressure based on its inlet flow and pressure. The 
calculated outlet pressure by the final element for an assumed flow in a stream will be used in 
conjunction with the downstream and upstream vessel pressure to calculate a new guess for the flow 
to force convergence of the stream outlet to match the pressure of the downstream vessel. This new 
flow guess Is then used in the next iteration of the stream calculation. A convergence block will be 
introduce after the last element of the stream to calculate the flow guess to force convergence as 
illustrated in the following example. 



I. 



Vessel 
Simulation 



New Guess for stream flow — for next iteration 



Pump 
Simulation 



A-BrhJcfTng 
^ Valve 



Simulation 




Teat 

Exchanger 
Simulation 



Upstream vessel pressure 



Calculated downstream 
pressure given flow 



Convergence 
Element 



1 — I 



Vessel 
Simulation 



T 



Downstream vessel pressure 



The elements that are contained after a pressure source within a stream, such as valve, heat 
exchanges, and pipe, are characterized by the fact that the flow through any one of these elements is 
related to the differential pressure across the element in the following manner: 
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Element 1 Differential pressure = K1* (Flow 
Where K1 Is the characteristic resistance for that element 



(1) 



For elements such as a regulating valve, the characteristic resistance is a function of stem position. 
However, during the convergence iterations for a stream, the resistance associated with each element 
may be considered to be constant. Thus, assuming the flow through each element of the stream is 
the same, then the total pressure drop Introduced by the N elements in the steam Is: 



Total stream pressure drop = (K1+K2+...KN)* (Flow)^ 



Based on this fact, then it is possible to calculate the system resistance for a known pressure drop 
and flow. 



During the first iteration of the stream calculation, the stream element will be evaluated in the same 
order as the flow through the stream. Based on its inlet pressure, each element will calculated its 
outlet pressure for the assumed stream flow. On the first iteration, the last stream flow will be used. 
Based on the upstream pressure and the calculated outlet pressure of the last element in the stream, 
the total system resistance will be calculated. Using this calculated system resistance and the 
pressure differential between the stream pressure source (vessel or pump) and the downstream 
vessel, the a new guess for flow may be calculated and then used in the next iteration. 



Using this procedure, the stream flow-pressure calculation will normally converge within two 
iterations ( valve, iieat excitanges, pipe) or titree iterations (multiple elements with pump as 
pressure source). 

In this section, the structure of steam elements will be examined based on this approach in resolving 
pressure-How Interaction and their interaction with process vessels. 

3.1 Stream Element 



As part of the stream element configuration, the user may be define the basis stream simulation to be 



Pressure based - a constant pressure is provided. The flow through the stream will be 
provided by the converge block. 

Flow Based -a constant flow and pressure output is provided independent of the converge 
block or the downstream conditions. 



In most applications, the stream element will be configured for pressure based i.e. will be the 
configured default value will be pressure based. The communication of pressure and flow properties 
associated with the stream element may be represented as illustrated below. 



= KTo«al*(FIOW)^ 



(2) 



Kjotai = Total stream pressure drop/(Flow)* 



(3) 



New Flow Guess = SqRt ((Source Press-downstream vessel press)/ Kjotai) (4) 





Guess Flow 



Stream Element May Be a Pressure or Flow Source 
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The connection status passed between Stream Element and a processing element will reflect the 
basis associated with a connection i.e. pressure or flow. 

Out Status Description 

Good_F Flow Basis - pass the flow through the steam 

Good_P_F Pressure Basis -> calculate downstream pressure based on flow, 
closed valve elements may set flow to zero. 



Based on this status, the dov^mstream element will automatically calculate pressure or flow. If a 
stream element is configured as a reference to a stream In another process module, then this stream 
will automatically propagate the connection status of the referenced stream. 



3.2 Regulating Valve 



A regulating valve element that is open will calculate its outlet flow and pressure based on its inputs 
status 

Input Status Calculation done 

Good_F The inlet flow and pressure are propagated by the valve independent of the stem 

position. 

Good.P.F The outlet pressure is calculated based on the inlet pressure and flow 

If a regulating valve stem position is below its minimal controllable flow and the inputs status is 
Good_P_F, then the outlet flow will be set to zero, outlet pressure will reflect the downstream 
pressure, and the outlet status set to a value that indicates no flow through the steam is possible: 



Outlet Status Condition 

Good_P Pressure basis stream (input status is Good_P_F) but valve is closed. 



Fl0M£ ^ 

Pressure ^ 
_Sjatys.«^ 




Pressure 



The valve calculation will assume a static mass and energy balance i.e. the flow, chemical 
composition and temperature in and out of the valve are the same. The calculations done will be 
based on the flow through the valve being related to the valve stem position, and differential pressure 
across the valve in the following manner. 

P = CvMax*f(l)* Sqr(dPv / Gs) (6) 



Where: 

F = Flow in GPM e.g 250 
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f(l) = Flow characteristics 

Linear: f(|) = I 

Quick Opening: f(l) = SquareRoot(l) 

Equal Percentage: f(l) = R^*"^^ 

1= % Valve Open/100 
CvMax = Valve coefficient at 100% open. GPM/psi 
Gs = The specific gravity of the fluid (1 at 60 degF) 
dPv = Pressure Differential in psi 

R - Vaive rangeability. Ratio of the maximum to minimum controllable flow 
through the valve 

Thus, if the valve is open and the input indicated a Good_P_F status, then downstream pressure will 
be calculated as follows based on the inlet flow 

Outlet Pressure = Input pressure - Gs (F /( CvMax*f(l)))^ (6) 

Note: The Calculation above does not include viscosity correction factor, assumes Reynolds number 
is greater than 3500. Need to do calculation in SI units. 



3.3 Blocking Valve 

The inlet status, pressure and flow will be propagated by an open blocking valve. When the blocking 
valve is closed, then the action taken depends on the inlet status. If the status indicates a flow basis 
stream i.e. status is Good_F, then the flow, pressure and status will be propagated even if the valve is 
close. If the inlet status is Good_P_F or Good_P and the valve is closed, then the out flow will be set 
to zero, the outlet pressure reflects the downstream pressure, and the out status set to Good_P. 

The user may specify the rate at which the valve closes. During this transition, the changing valve 
position will be reflected in the pressure for a pressure basis stream.. 




Flow 



_SLatys. _ 



Prcssur^ 



2^tatus_^ 



Process 
Element 



Pressure 



The calculations associated with the blocking valve will assume that there is no pressure drop across 
an open blocking valve. 

3.4 Fixed Speed Centrifugal Pump 

A pump may be the pressure source for a stream i.e. the start of a pressure basis stream. The 
discharge pressure will be determined based on the suction pressure and the discharge flow. When 
the pump is shut off, then the discharge pressure will revert to the pressure of the downstream 
element. 
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Flow ► P'ow ► 
Pressure ^ C^J""^ Pressur^ 
Status ^ _ -Status. ^ 



Process 
Element 



Pressure 

The fixed speed pump calculation will assume a static mass and energy balance I.e. the flow, 
chemical composition and temperature in and out of the valve are the same. The calculations done 
will be based on the flow and differential pressure across the pump being related in the following 
manner. 



F = FM«-(dP/Kpu„,pr 



(7) 



Where F = Pump discharge flow 

Fmbx = Maximum block possible (zero system pressure loss) 
dP = Discharge pressure — Inlet (suction) pressure 
Kpump Pump constant 

Thus, when the pump motor is ON, then the discharge pressure may be calculated as follows: 



Outlet Pressure = Input Pressure + Kp„mp* SQRT( Fivu«-F) 



(8) 



If the pump is off, then an outlet flow of zero and status of Good_P will be calculated. 



3.5 Pipe Segment 

The pipe connection between processing elements will normally be assumed to have no impact i.e. 
status and properties are propagated. However, if the user configures the a length and diameter and 
the Inlet status Is Good_P_F. then the pressure loss Introduced the flow through the pipe will be 
calculated based on the inlet flow and status. 



Flow ^ 

Pressurg r 
.-Jtatus^*- 



Flow 



1 Pressure . 



T — iStaUJs.. 



Process 
Element 



J 



The flow and pressure drop across the pipe may be calculated as follows: 



Dp= K2*F^ 

Where: 
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F= Pipe flow 

Dp = Differential pressure drop across a pipe 

K2 Pipe constant (characteristic of pipe diameter and length) 

Thus, the outlet pressure may be calculated as follows: 

Outlet Pressure = Inlet pressure - K2 • F* 

When a pipe Is configured, then the composition properties associated with the output connection will 
be the same as the input (assumed plug flow) but dynamically delayed based on the flow rate and 
size and length of pipe. 

Composition Out(t) = Composition In(t-tDciay) 

Where today = Pipe Volume/Flow Rate 
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3.6 Heat Exchanger 



Since the outlet flow of a heat exchanger is the same as the outlet flow and can change quickly based 
on upstream and downstream condition, then the heat exchanger will be treated as a processing 
element in the connections between vessels. 

The pressure flow relationship in the process steam in the process flow to and from the heater can be 
described as follows. 

Dp= K2*F^ 
Where: 

F= Process flow 

Dp = Differential pressure drop across the heat exchanger 
K2 = Heat exchanger constant (characteristic of exchanger size) 
The outlet pressure may be calculated as follows: 

Outlet Pressure = Inlet pressure - K2 * 

The outlet temperature may be calculated as follows assuming liquid flow through a single pass, 
single shell pass counter current heat exchanger. 

N1 = U A/W1Cp1 
N2 = U AAA^2Cp2 

T2out = [[Exp(N2-N1)-1]T1ln +I1-N1/N2]T2in]/[Exp(N2-N1) - N1/N2] 

T1out = [ Exp(N2-N1)I1-N1/N2]T1ln + N1/N2[Exp{N2-N1)-1}T2ln ]/ [Exp(N2-N1)-N1/N2 ] 
Where 

U = Heat transfer Coefficient - W/(m2 K) 

A = Heat Exchanger Area - m2 

W1 = Mass Flow Tube Side - kg/s 

W2 = Mass Flow Shell Side - kg/s 

Cp1 = Specific heat of liquid in Tube — kj/(kg K) 

Cp2 = Specific heat of liquid in Shell - kj/(kg K) 

Tlin and Tlout = Tube inlet and outlet temperature - C 

T2in and T2out - Shell inlet and outlet temperature - C 
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3.7 Vessel Simulation 



The simulation of each process vessel will be done assuming that the inlet and outlet flow are 
constant for the vessel calculation. In this section, we consider some basic vessels to illustrate this 
concept. 

3,7. 1 Atmospheric Tank 

The simulation of an atmospheric tank will include the calculation of the tank level. This level will be 
calculated at each step of the simulation assuming that the inlet and outlet flows are constant 
Checks will be made to insure the calculated level remains within the tank height and does not go 
below the height of the pump out connection. Also, based on the specific gravity of the material in the 
tank, a liquid head pressure will be provided for each input and output connection. For the output 
connections, the associated status will indicate if the liquid level is above the connection point. 

LevelNew = Leveloid ( sum of Input flows - sum of outlet flows) ^(execution perlod/60)/K 

If Level > Tank Height Then 

Level = Tanks Height 

Endif 

If Level < Height of Pumpout Connection 

Level = Height of Pumpout Connection. 
Outstatus = Good.P 

Endif 

Where K = Tank constant. Cubic Liters/Liter 

4 Example Implementation 

Composite blocks may be created in DeltaV to test and demonstrate the elements defined process 
simulation of elements in a stream, as discussed in section 3. In this section, we show an example 
implementation of these simulation elements. These examples address the following elements: 

• Stream 

• Constant Speed Centrifugal pump 

• Regulation Valve 

• Blocking Valve 

• Pipe 

• Converge Block 

• Test Vessel 

• Tank 

• Heat Exchanger 

• Variable Speed Pump 

The test vessel and the stream element to create the upstream pressure source. An example of how 
these composites may be used to simulation a stream consisting of a steam element, regulation valve 
and vessel is shown below: 
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4.1 Named Set Definitions 



To make it easier to use enumerated parameter in the process simulation bloclc definition, the 
following named sets were created in this example. 



Name Set 


Enumerations 


Value 


Description 


BASIS 


Pressure 


o 


The calculation basis 




Flow 


1 






PROC.ST 


No_Connection 


0 


Connection Status Definitions 




Good_P_F 


1 


Pressure and Flow may vary 




Good_P 


2 


Pressure may vary. Flow = 0 




Good^F 


3 


Flow is constant 




VALVE^CHAR 


Linear 


0 


Regulation Valve characteristics 




Equal Percentage 


1 






Quick Opening 


2 






BLK_VALVE 


Closed 


0 


States of a blocking valve 




Open 


1 






Motor 


Off 


0 


Motor state 




On 


1 
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4.2 Named Basic Properties - Use of Array Parameter 



To minimize the number of connections between blocks, an IN and OUT parameter is provided in 
each block. These parameters are defined as floating arrays (6x1) so that the five basic properties of 
each connection plus the status may be exchanged with a single connection. The properties 
associated with a block output are put into OUT array parameter using a transfer output Calc/Logic 
block. Similarly, the values in the IN array parameter are unpacked and put into the block Input 
parameters by the Transfer Input Calc/Logic block. A typical example of how this Is done in the 
construction of a composite block is shown in the following: 



m 



CV-C 



Example of IN and OUT for Transfer of connection Properties 



The expression for the Transfer Input Calculation block is shown below: 



IF {•"/IN'CSHIl I- 0) THEN 
•^/PRESJN*:» ""/IWdlll; 
•"/FLOWJN* :» •"/IN* (21111; 
•^/DENS JN' :« •"/IN* PMl J; 
•"/TEMPJN* •"/IN* 14)11 1 
•"/SPHT IN* :o •"/IN* [51111; 
•"/IN.Sr :»*"/IN*|61I11; 
ENDIF: 



(" II not corviecled. then this is a source") 



The expression for the Tranfer Output Calculaton block is shown below: 
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5 
6 



'^/ouT*[2irn 

VOUT'PMll 
"/0UT*[4JI11 
"/OUT* PHI 1 
V0UT*[6ini 



.•"/PRES OUT'; 

.*"/DENS our; 
'•"AEMP OUT'; 
^•"/SPHT^OUT'; 
'•"/OUT.ST*; 



The input and output parameters are currently also shown as connection points just to allow the 
values to be easily viewed for checkout - should not be connected to in building example.. In the 
future most of these input and output parameters will be change to intemal Inputs and output that wilt 
be viewed from the left hand pane when the block is selected. 
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4.3 Named Steam Element 



STREAM 



The stream element is defined as a composite template. This block 
utilized the following parameters and algorithm. 



4.3.1 Stream Parameters 






'^riConnectS^^ 


BASIS 


Pressure 


Internet read only 


Named Set 


BKCAIJB^^P- 


a 


mput 


Ftoat^g point i 


BKCAL^Oirf... 


l9. 


. Output 


FloaUng point 




1000 


' Input 


Float^g point { 




\o' 


Output 


Floating point | 


FLOW.IN 


0 


1 Input 


Fbating point { 


fUOVV_OUT 


0 


\ Output 


Ftoating point | 






', Input 


Floating point array | 


iiJST 


Mo_C«nnecl.. 


■ bipiri 


Named Set 1 


OUT 




[Output 


Ftoating point array 


OUT.ST 


No.Connect. 


. Output 


Named^Sel 




0 


\ Input 


Ftoating point 


"PRfS.buf 


0 ■ ■ ■ 


' Output 


Ftoating point 


SPHT.W 


4.184 


' Input 


Ftoating point 


SPHT.OUT 


0 


Output 


Ftoating point 




yo 


.Input 


Ftoating point 


TTEMP.OUT 

■ 


0 


. Output 


Ftoating point \ 



4.3.2 Stream Algorithm 



1 

2 
3 
4 
5 
6 
7 
8 
9 
10 
11 
12 
13 
14 
15 



r/PRES^OUT':o*"iWES IN*; 

•"/DENS^OUT*:o*"/OENS IN': 
*"/TEMP^OUT* •^/TEMP'^IN'; 
*"/SPHT 0UT':-*"/SPHT1N'; 
IF •"/INST' - PROC^STrN'b.Connecliai' THEN 

IF ^/BASIS' « BASISiPiessure* THEN 

•^/OUT.ST'toPROC ST:Good P P: 

ELSE 

*"/OUT_ST* > PROC.ST:GoocLF: 
ENDIF; 
ELSE 

•"/OUT_Sr:o*"/IN ST'; 
ENDIF: 

•"/BKCAl^OUT.PRES^ro-^/BKCALJN PRES*; 



("Stream always propogates properties"] 

r* If connected, then thus b a s«irce*) 
("Source of Press and Propagate Flow*) 
(Souea of Flow and Propagate Re«$ure*) 

(*Acling as a cormectioa Ptopagate IN.ST*) 



577 



4.4 Constant Speed Centrifugal Pump Element 

The pump element is defined as a composite template. This block 
utilized the following parameters and algorithm. 



4.4.1 Pump Parameters 



RXf^t OllT 
DIVW\V.W 1 ... 


0 
0 


Input i Fioflting point 
. Outotn 1 Ftoatkig point 




1 1000 


; Input _ 


FtoAiiftp potm 


'CEUtjoifT" 




Output 


Ftoflthfl point ~ 




To 


: ^^^^ 


Ftoatlns polm 








FioAtino point ' 


FLOVCOlfT 


lo 


Outout 


Ftoating pobrt 


II 




hput*''" 


Fbating point srra/ 


H.ST 


1 Ho.Conneci... 


: mpui 


iiamed Set 


OJT 


1 _ 


: Outti u l^ 


FtoaUnff po&n array 




; no_Connftd„. 


■ duQtUt' 


Naaad Set 




: D 


Input 


Ftoattog paint 


««sjouf 





j Oi^ ul _ 


fjotjsng point 


" PUUP^OMSf 




. trtttfrnBi read only^ 


Floating point 


fWiP-?rAT|_ 


* On 


^inpuT^.."."! T. 


uatws Set : 


^~SPMT_W 


4.184 




Fbatng point 


SPHT.OUT 




; Output 


Floating point . 


TEMP.IH 




Input 


Floating point 


TEMP.blfT 


0 


' Output 1 Fiottlnfi poim 



4,4.2 Pump Algorithm 



24 

2S 
2G 
27 
26 



30 
» 
32 
33 
34 
36 
36 

i 

3S 
4G 

41 

42 
43 



IF|*"/IN_$r« 'PROC_$T:No_Connection'I THEN f f«l conmded. Ihen prapapate and st^tufj 
•*yOUT.ST* T>ROC.ST:Goo(tP P; 
""/PRES_OU T* ''/PBES.IN': 

•~/BICCAL.OUT_PRES* :- •^KCW^IN.PRES': 

ELSE 

^ IF ( ^/IM.ST* . *PnOC.ST:Goo<Lr ) THEN (- Coratvt Row. prap«9al» pmwe flew «talut 1 

8 •*/OUT_ST':--/lN^ST'; 

S •^yPRES.OUT* :- •*A>fiESJ*f ; 

IC "^yFLOW^OUT*:- •*yFU3W JN*; 

1 1 •^VBKCAl^OUT.PnES' : - •^KOVLJN.PRES*; 

12 ELSE 

13 IF I "^/FtJMP.STATE* • VOTORzOIT | THEN p Oetermine if pump fwwB"! 
K ^/fUMJ}\)V:»aO: |-Moto«oOnoaov»po»cibb''| 

15 ^/PRES.OUT* :- */BKCAL fN.PRE 5*: 

16 '^/BfJCALJOUlJ^ES' ^/PRES JN'; 

17 -AWT.ST* : - WtOtLS T:Go«LP: 
1Q ELSE 

ia IFC*/IN_Sl*-FROC.ST:GooiLP| THEN 

20 *^^LOW.0UT' :» ao ; C No Bow i^Kbeant propooate pien 1 

22 •^/BKCAL.OUTPRES :- */PRES_IN': 

23 •*/DUT.ST' '•/IM.ST'; 
^ ELSE 

IF I'*in.0W.IN*>'*yFLOW'MA>C)THEM 

-yFtOW.OUT' -yFLdW.MAX'; 
ELSE 

-yFLOW.OUT* -/FUJW IN*: 
29 ENDIF; 

FToctpi;- |-^OW.MAdC -**yFL0W.0Ur ); r C«k»ialed3chatg»p(etsue-) 
IF(FFactOi<aO|THEN 

FFee«oi:*aa- 
ENDtF: 

•"/PRES.OUT':-'"/PRES JN'M'^/POMP.OOMSrj • SQRT( FFactor | 
•"/BICCAl^OUT PRES- :- '*>PRES.W; 
-AjUT SF^.-'yiN ST'; 
ENOIF; 
ENDIF: 
ENOIF: 
ENDIF: 

•*yOEHS.OUT':.*'/DEN$ IN*; 
-/TEMP.OUT* > '^/JEHPJU'i 

VSPHT OUr:»'*/SPHT_IM j 



4.5 Pipe Element 

The pipe element is defined as a composite template. This block 
utilized the following parameters and algorithm. 
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CSP^PUUP 




4.5.1 Pipe Parameters 



Parfimeier - - | 


OefauB ' 


1 Connection type | 


Paramelerjype ' 




0 


. Input 


Fbating point 1 




0 


; Output 


Ftooifang point !' 


DENS^W • 


lobb 


• input 


Floating point 


OENS.OUT 


0 


Output _ 


Floating point 


>LOWlw 


0 


i^p"* 


FteaUng pohrt . 


FLOWJDUT ' 


^0 


Output 


Floating point 


"w 




Input _ 


Floating point array 


W.ST 


No^Connect.. 


Input 


Named Set 


OUT { 




. Output 


FloaUng point array 




No.Ceftnecl. 


. [ btf^ut 


named Set 




0 


* mtemal read only 


Fbating point 




6 


to p ut 


Ftoating point ; 




b 


Output 


Ftoa^g point j. 


"spmtIw 


4.184 


• Input 


Ftoating point ! 


SPHT.OUT 


0 


! Output 


Floating point i\ 


TEMP.BI 


30 




Floating point { 


TEMfLOUT 


9 


; Output 


Floating point j' 

"r 



4.5.2 Pipe Algorithm 

Wt^AH Sr- PROC_ST:No_Conncction*) THEN fi 
""•^AJUT ST':-PROC ST:Go«LP-f; 
•"/PRES OUT":-'"/PRESJN'; 



1 
2 

3 
4 

5 
6 
7 
8 
9 
10 
11 
12 
13 
14 
15 
18 
17 
10 
19 
20 
21 
22 
23 
24 
25 
26 
27 
28 



nol connected, then propagate value and ttatus") 



ELSE 



"yPLOW OUT*:-*^^aW IN'; 
•"/BKCACOUT^PRES' :« "^BKCALJN.PRES'; 



ELSE 



"/IN ST' » •PRaC.ST:6ood.P)THEN 
•"ytfUT ST*:»'"/IN_.$T*; 
♦"/PRES OUr:o-"/PRESJN'; 
*"yFLOW OUr:»*"yFLOW IN'; 
"yBKCAL_OUT^PRES' :» •^KCALJN.PRES'; 



(« Constant flo%w. propagate pietttjre flowslatu»1 



THEN 



IFC-^yiN ST oPROC^STrGood^P") 
"'/FLOW.OUT'roO.O; 
^/PRES^OUT*:- '"/PRESJN'; 
*yBKCAl^OUT_^PflES :« '*/BKCAt.lN_PflES': 



p No flow upstream, propaoate press *) 



ELSE 



'*/0UT.ST':«'^1N.Sr; 



"/FLOW.OUT':-' 
"^ES_OUT':- 



ENDIF; 
ENDIF; 
ENDiF; 

•"/OENS^OUT' 
•"/TEMP.OUT- 
•^ySPHT OUT' 



*"y8KCAU.0UT mES':- 
'*A3UT.5T':-"*/IN.ST'; 



VFLDW IN'; 

'^/PRES IN' - (""/FLOW. 
•*>PRES IN 



(' CatcUlaie pipe oUtet ptemire ") 
UN' • •"/FLOWJNT'^^PE-CONSr ; 



-•"/DENS IN*; 
- ""/TEMPJN'; 
VSPHT JNV 
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4.6 Regulating Valve Element 

The regulating valve element is defined as a composite template. 
This block utilized the following parameters and algorithm. 

4.6.1 Regulating Valve Parameters 



BKCAL^W.P... 


0 i input 


i FtoAtinQ point 


BKCAU.Ol/T... 


0 1 Output 


1 Floating po&ij 


CMARACTERL.. 


Unear 


Internal read cn?y 


S Named Set ] I 


_ CV 


V8 


Intemel read only 


1 Ftoatinfi poht i 




10CO 1 Input 


i Fb sting point ! 


DEWS.OUT 




Output 


{ Floeting point j 




0 


Input 


! Floatinc point 


" ~FLOw_oirr 


^o'"'** 


Output 


f FtoBtiig poht _ • 


w 





input 


• Fteatkig point array : 


tti.ST 


No^Conneci.,- 


Input 


j NarwdSct ; 


OUT 




Output _ 


1 Ftoating point array J 


outIst 


«o_Connect.. 


Output 


} Marrttd Set i 


PR£S_IN 


1 0 i Input 


i Floating point 


~ presIout" ~ 


10 


Output 


i Floating point j 


RAHGEABnJTY 




Intemsl read only 


: Floating point 


SP£CFIC^GFL.._ 


j^iT 


Internal read only 


• Floating point ' 






Input 
Output_ 


1 Ftoating pointy J 


SPKT_0UT 


i 0 


j Ftoatiig POlnl_ ^ 






Input 


! Floating point 


TEMP.OUT 




Output 


j Floating point i 


VALVElikisi". 


K- — 


1 Input 


1 Floating point 



REG^VALVE 
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4.6.2 Regulating Valve Algorithm 

IF I '•/IK.ST* • •PROCLSTtNo.CowttCbon* ) THEN f II nol eomected then fnopaodla vakis and flat 
•^/OUT ST'i-TflOC^TiGootLP-P: 
•"4>RES^0UT* '"/PRESJN*; 
•"./FLOW OUT' :- •"/FLDWJN*; 
•"/8KCAU.0UT^PRES- -^/BKCALJN.PRES*; 
ELSE 

IF ( '^AH %V • T«OC.ST:Goo<LF* ) THEN Comtani Bw, pcopaoate pt«»*o Itow «lalut 

•"A)UT ST-.-'^/IN.ST': 
•"/PRES^OUT* :- *"/PR£S JN*; 
•^yFLOW OUT*:-*^/FLOW IN': 
•^ySKCAL OUT.PRES':-*^>XAL.IN,PRES'; 
ELSE 

MnmonOpen :- (1 OaO / •^/RANGEABIUTY 1; {' Mremro cperbng la flow '1 

IFr/VALVE POSITION- KMkwnumOpen) THEN r Oeteom 9 valve i» closed 

•*/FLOW OUT' :- ao : |' Vrive tmed. no flow pottibia ") 

-*/PRES_OUT' "^/BKCAL IN.PRES-: 
-/BICCAL OOT^PRES':- •*>PRESJNV 
-/OUT St ' :- fR0C.ST:6oqd.P; 
ELSE 

IFC'yiN ST-.PROC 5T:GQod.PJ THEN 

-^/FLOW OUT' :« 9lO : (* No Row upstream, piapagalB piats 1 

•^/PRESjaUT':- '"/PRES IN'; 
•^/BKCAI^OUT^PRES':. */PRESJN'; 
*"A)UT.ST->'*/IN^Sr: 
ELSE 

•^/FIOW.OUT' -"/aOWjN*: 

FfadkmOpen T/VALVE POSITION* / 1 00.0 1' (" Dalenmnd dovmstro precsl 
IF^iOIARACTERlSTICS' • VALVE;.CHAR:Un0ai' ) THEN 

FkMwChM FraetiorCpen: r Uneai 1 

ELSE 

lFrA>IARAa£RISTICS* - VALVE.CHAR;Qi^ Opening ) THEN 

FloMChM :« SQRT( FiaeliortOpen ) ; (- Qiick Opanino ') 
ELSE 

Po«Maf:« (FracliGrOpen*1.0b fEqMdPeicentage-) 
F1oMNCh« EKPTC^/RANGEASIUTV.Pwrai): 

37f ENDIF: 
3GI ENDIF; 

391 FlFactof:- ('"/FLOWJN' / I'^/CV * Fte*MChaf)l 

4G ^yPRES OUT- I "^ESJN* • ( FFartoi ' FFaoloi • ---/SPEanC.GHAVnY | ]: 

41 -"/BKCALLoUT ffiES* :• ^/fHtSJH': 

42 -"/OUT.ST' '/IN.ST';| 

43 ENOIF: 
ENDIF: 

ENDIF; 
4El ENDIF: 

47 -^/DENS.QUT- -"/DENSJN"; 

48 -*/TEMP OUT':«'"/r£MPJN'; 
43 -^/SPHTrOUT* -^/SPHT^IN'; 



581 



4.7 Blocking Valve Element 

The blocking valve element Is defined as a composite template. This 
block utilized the following parameters and algorithm. 



4.7.1 Blocking Valve Parameters 



BK CAL,IH _P... 

BKCAL^ciinr.. ' 

OENS_iN 
FLOW W 



0 

1000 

6" 

0 



hiput 

^Output 
- Input 



: Output 
. mpui 



flOW^OUT !o 

OUT 
OUT,ST 
PRES_W jo 
PRESIOUT i 6 



j PjoathiQ poiftt 

; Roatins point 
! iF(ofltb»9 pobit 
j Ffoflting point 
j Fioatino point 



J! 



SI 



Ho.Ccnneci. 



Mo Connect. 



SPHT.W 
SPHT^OUT 
TEMP W 



{ 4.1S4 
10 



1 30 



VALVE.STATE | Open 



.TE| ( 



1 



, Output 
[ Input 

Input 
: Output 
! Out put_ 

Input 
_Output__ 
. Input 
■ Output 
, mput 

:_OutpUt 

I Input 



I Ftoatino point 
j FtoatinQ pobit arra/ ij 
I Named Set ^ J\ 
i Fioattng point array i 

j Named Set 

I Fioatbid point 

i Ftoat tng point 

I Floating point 
1 FtoatbiQ point 



I Floating point 
! rtoatlng polnji 
i Named Set 



BIX_VALVE 




4.7.2 Blocking Valve Algorithm 



1 

2 
3 
4 

s 

8 Et.SE 



7 
6 

9 

IQ 

11 
12 
13 
14 
IS 
16 
17 
16 
IS 
2C 
21 
22 
23 
24 
25 
26 
27 
28 
2S 
30 
31 



IF ( ""/IN ST ' « FROq.ST:Nq.D)nnBCtianr | THEN f U not conneolad. Ihen prapapate v«lua and cWua" 
•^/OUT ST* 'PnOCBT«oo4,P-r; 
•"/PRES OUT' ""^^ESJN'; 
•^'jamiT mn*'m**'jnnsAt in** 



■•yFWW.OUT':- •*yFLOV»LIN'; 
'^/BKCAL.OUT.PRES' •^^BKCM^IN^PRES'; 



IF! 



ELSE 



^AHJSV . T»ROC.ST:Ooo<Lr)THEN 
'"/OUT.Srr-'^yiN.ST': 
•*/PHES.OUT* :• -/PRESJW; 
■*/FLOW_0UT* :• -^yFtOW IN*; 
'/Btt:Al^OUT.PRES* '^KCAl^tN.PRES*; 



rCbn^iariiflow.ptopaoatepiesftra rkM«itfut1 



IF I ■^iVALVE.STATE* - 'BLOOC^VALVEiClDte* 1 THEN f Deiannne if valve is dosed •) 
•*yn.0W.OUT':- ao : r Valve to*ecl no flow pos«ble "I 

•*yPRES.OUf ' -"/BKCAL IN_PBES!: 
•^/BKCALtttJT PRES*:-^/PnESJM*; 
•^/OUT'S^*:. ' ^ 



ELSE 



-^OC.STiGoatP'r 



THEN 



MN.ST* - TOOC.STiGoatP' ) 
•"/FLOW^0Ur:-a0; 
-/PRES.OUT*:- '"/PRES IN*; 

J3UT.PRES*:- ^/PRESJW; 



(* No AoM i^tlieofn. propagate pf CM *) 



ELSE 



AMJT^ST'i-'^yiM.Sr; 



VaOW^OUT* •*/FUJV/ IN*: 
-yPRES^OUr:- •"/PRE^JN' 
'•/BKCAk.OUT TOES' •"/PBESJN*: 
'^/OUT.Sr:.''/IM_ST'; 
ENDIF: 
ENDIF; 
ENDIF; 
3^ ENDIF: 

33 •*yDENS.OUr:.'*yDENSJN*: 

34 -/TEMP.OUr IN*; 

35 ■*/SPHT.OUf:«-/SPHTjN': 



(* Valve opatx prapagafce noinf end prets 1 



4^8 Convergence Element 

The convergence element is defined as a composite template, 
block utilized the following parameters and algorithm. 



COHVERGE 



This 
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4.8.1 Convergence Parameters 



. Panimeter • ' f *\ . Oettuft' 




• ' 1 ^Pammeter'tiniei^iv'f - 


BKCAL^W.P,.. 0 




Input 


1 Ftoating pobit 


BKCAL^buf.*. • 0 




Output 


1 Floating point 


OENS.M : tOOO 


1 Input 


1 Ftoating poltir 


OENS.OOT ■ 0 


1 Output 


i Ftoating pobit 


FtOW.W 0 


1 Input 


i Ftoatkig poM 


Ftow,our ■ 0 




Output 


Ftoating point 


"ii " " * " 






j Ftoating point array 


IM^ST ; •?'l-,p*f*?.*?*i:i. 


Input 


j Named Set - 


OUT 


i Output 


1 Ftoating point array ' 


OUT.ST i'.^-p.*!.'?!?*??!!-. 


Output 


_ J Hao^ S«t 






taput 


_ j Floating point \ 






Output 


i Fbaihg point { 


SQURCE.PRES' 0 


Input 


I Ftoating pobit -A 


SPHT_W 


hput 


1 Ftoating po6it 


SPHT_OUT • 0 


Output 


1 Ftoating point \ 


TtEMP.W ' 30 


Input 


t Fioat&ig point ] 


TEMP.OUT . 0 


i Output 


{ Ftoating point 





4.8.2 Convergence Algorithm 

Ifi-^AHJSVm TaROC.ST:No.Connection') THEN Tlf noteomeetodlthertfvopagetevaluoondlSM^ 
-y0UT.ST >'PR0C^ST:6oc<.P P; 



. 2 
3 
4 
5 
6 
7 

e 

s 

1Q 

n 

12 
13 
14 
IS 
16 
17 
18 
19 
2Q 
21 
22 
23 
24 
25 
26 
27 
26 
29 
30 
31 
32 
33 
34 
35 



ELSE 



-yBKCAl^OUT.PRES';- '^^BKJZAl^lN.PRES'; 



iFC^ytN^Sr - "PROQ.ST:GoaLP|THEN 
•*A)UT_ST':-*"V!N ST'; 
^VPRES_OUT':.-"/PRES IN'; 



C Constant flow, prapogete pressure flow «totu* ") 



ELSE 



•~/BKCAl^OUT.PF»ES':- •^/BKCAL.JN.PflES*: 

IF(-y»4.ST' • •PROC.STrGoocLP' I THEN 

;2/n.0W.OUT* :- ao ; C No flow <<»sttem propagate pten 'I 

•^/PBES.OUT*;- *^yPRES IN': 
•"/BICCAl^OUT PRES*:- '^/BIXAI^IN.PRES'; 
-"/OUT_ST':--^/IN ST; 



op > '*/SOURCe.PRES' - **/PRESJN' ; r OP For oa 
I :• CalcPlrotOrep / C^/FLOWJN' • "^/FLOW IN'l; 
f '*yS0URtt.PRES'.-/8KCAL^IN.PRES' 1 7 Retia 



ELSE 

IFr^OWJN'<- 00) THEN 

•"/FLOW^OUT* 1 ; p Row mutt beGT Otocalc 
ELSE 

ColePie<Orop 
RositlanBO 
RFoetOf 

'^/maWJQUV SORT ( FlFocta | , 
ENOiF; 

•"/PRES.OUT*:. -yBKCAL^IN.PRES*; 
•"^BICCACOUT^PRES*:- •"/BKCAI^IN.PRES* : 
•"A)UT^ST*:«'*/IK_Sr; 
ENDiF: 
ENDIF; 
ENDIF; 

•"VDENS.OUT':-'^VOENS IN'; 
•"/TEMP_OUT':.-/IEMP IN*; 
•"ySPHT^OUr :. -/SPHT JW: 



by again u«aig 1 ") 
OMumed flow r) 



Rastttanoo ; 
r New guass foi flow 1 
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4.9 Test Vessel Element 

The test vessel element is defined as a composite template. This block utilized the 
following parameters and algorithm. 



4.9. 1 Test Vessel Parameters 



BKCAt.OUT.. 

oemsjoJt " 

FLOwjl 

_FLOwl^oinr 

m ' 

OUT 



0 

fiooo ' 

To 
i ?■ 

Ho Connect.. 



Input 
1 Output 

* Output 
jinput 

] Input 
' Input 
; Output 



OUT_ST__ 

PR£S3UT^ 
SPHT IN 



j Output 
* Output 



i Warned Set 
I Ftoatbtg poini 
; Fto a ting point 
j Ftoatlnp point ^ 
: Frosting point 
: Ftoating poht 
i Floating point _ 
* Floating point array 
- Warned Set 
I JFtoating^oint array 

\ Floating point 
j Ftoating point 



SPHT^OUT 



TANK_PRES 



I 790 



TEMP W 



30 



TEMP.OUT 



I 

j Output 

i friternai read only 

; Input 

I Output 



Ftoati ng point 
JFIoatbig p^'mt 
Ftoating point 



J ^to^ting^oint 
i Ftoating point 




4.9.2 Test Vessel Algorithm 



r/PRES OUT*:=*VTANIC PRES'; 
•"/8KCAU_0UT_PRES* :« ^/lAHKJPBtS' : 
IF (-"/BASIS* °'BASIS:Premffe*]THEN 



ELSE 
ENDIF; 



-^/FLQWJQUV *"/BKCAU_IN_FLOW; p U« new calculated flow T 
•"/OUT.ST' :» f=»BOQ.ST:Good.P.P ; 



"/OUT.ST* :- 'PROC.STrGoocLF ; (" Fbw basis, use enteted flow value *) 
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4.10 Tank Element 



The tank element is defined as a composite template. This block utilized the following parameters 
and algorithm. 



4.10.1 Tank Parameters 







il2i^ral^SSSiySl^^s!!^!§^3P'S 


BASJS 


Dr oo o 1 i r A 


, ffiiemfli rsflo only 


! Nanrted Set 




; W 


^ uipui 


« f|??ti'!fl point 


"bkcaLIout.. 


- A 

< U 


t Output 


: Ftoatlng point 




ft. 


! uipuI 


1 Ftoatino point 






! Output 


; FloaUng point 








! Fl08t^$< point 


FLOW^OUT 




Outpul 


1 Floating point 




j 


'. Input 


Floatfrtg point array 




i No.Connecl.. 


i &iput 


i Named Set 


liqIdens 




Internal read only 


: Floating point 






^ inicrriBi reBO on^ 


j Floating point 


LtQJ.1ASS 


f 0 


1 Internal read only 


i Ftoattog point 


LIQ^SPHT 


: 0 


• Intemal read only 


;• Floating point 


LIQ^TEUP 


• 0 


' Internal read only 


Floating point 






- tnternai read only 


i Floating point 


" birr 


i 


: Output 


1 Fioattng point array 






; Output 


. Manned Set 


PEWOI^^^ 


Ti.~"^ 


; Internal read only 


1 Floating point 


posjri' 




j (nternal read on^ 


\ Floating point 


POS^OUT 




: Internal read only 


1 Float&ig point 


"PREsJft 


i , 


; Input 


' Floating point 


PRES.OUT 


1 0 


' Output 


i floating point 


SPHT.W 


Va 


• bput 


! Floating point 


SPHT.OUT 


0 


i Output 


1 Floating point 


TEMP.W 


1 0 


! Input 


: Floating point 



TEMP OUT 



Output 



THK^COHS 



Internal read only 1 Floating point 



Floating point 



585 



4.10.2 Tank Algorithm 



|F(*"/IN_Sr- TO0C.ST:No.C6iVk8Ction* 1 THEN f If not connected, then use o vdue 1 
ELSE 

IF I *^/IN.ST* o 'PROC STiGootLP ) THEN (- Constant fkwv. propagate ptestifla flow status -| 
•"/OUT_ST':-'"yiNlsr; 
•"/FLOW.OUT* :» •"/FLOWJN': 
ELSE 

IF ( ^AJQ LEVEL' < -"/POS.OUT') THEN (- Determine 3 level is bebw oOtlet «) 

^ •"/out ST* :-PROC ST:Go«LP*: 

10 •"/FLOW^OUT'ioO.O; (• No tow possWe •) 

ELSE 

1 2| •"/OUT.ST- :» 'PROC_ST:Goo<LP_F' ; 

1 ^ •^/FLOW OUT' •"/BKCAL.IN.FLOW ; 

ENOIF; 
15 ENDIF; 
ISjENDIF; 

Massin:- *"/FLOW IN' - '"/PERIOO^EXEC; 



18 FfacChng:»Massln/ ( Massin ♦ •"/LIQ^MASS' j; 



19 



''/UQ.DENS' p/DENS JN' ' FracChng ) ♦ r/UQ.OENS' - (1 • FrecChng ) ) ; 



2tf •^AJQ.TEMPio C^/TEMP IN* - FiacChng) ( •"/LIQ.TE MP* "(I- FracChng ) ); 
21 '^AJQ SPHT'ro ( *"/SPHTjN* • FracChng ) 4- ( '"/UQ.SPHT' - (l-FracChng) ); 
22'*"/UQ~MASS*:» *"AJQ MASS'-*^ p/FLOV/JN'. •"/FLOW^OUT* )- *"/P£RlOO_EXEC; 

23 *^ASU LEVEL* :« ('"/LIQ MASSV^/UQ DENS' ) /'"/TNK^CONS'; rCUfiler/meler/cuaer -) 

24 IF ( •"AJQ.LEVEL'>*"yMAK.LEVEL') THEN 

25 •"/UQ.LEVEC ""/MAK^LEVEL'; 

2S •"/LIQ.MASS" ( *"/MA><LLEVEL' • •"/TNK^CONS* ) " '"/UQ.OENS'; 

27 ENOIF; 

28 IF (•"AJQ^LEVEL'>'"/POSJN') THEN 

29 •"/BICCAL.OUT.PRES' ( '^/UCLLEVEL' • '"yPOS JN' ] • '"yUQ.DENS* ; 
30} ELSE 

31 •"/BKCAL.OUT^PRES* :« 0.0; TRelain last Dens, Temp, Spht in line -J 
321 ENDIF; 

3:aiFr/UQ LEVEU>-"/POS OUT') THEN 

34 '"/PRES.OUT' f "*/UQ_LEVEU • -^VPOS JUT' | ■ '"/UCJ.DENS'; 

35 •"/DENS JUT' '^/UQ.OENS'; 

36 '"/TEMP_OUT':»'"/UQ TEMP; 

37 ""/SPHT OUT':o'"/UQ SPHT'; 
ELSE 

39* •"/PRES.OUr:- 0.0; 
40 ENDIF; 
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4.11 Heat Exchange Element 

The heat exchange element is defined as a composite template. This block utilized the following 
parameters and algorithm. 



4.11.1 Heat Exchanger Parameters 







_ BKCAk.«l_R.. 


Lo 


1 Input 


Fbating point j 


BKCAL,m,R.. 


1 0 


; Input 1 Floating point 


bkcalJout... 


1 0 


Output 


Ftoatlng point j 


BKCAL^OUT... 


^0 


« Output 


Fbating point j 


DEMS_041 


i 0 


, hput 


Ftoatlng point 1 


0EHS_IH2 


K 


Input 


Ftoatlng point \ 


OEMS.OUTI 


i 


Output 


Ftoatbg point 


OENS.Oim 




Output 


Fbating point 


EXCHG.AREA 


i 100 


Internal read only 


Floating point 


FL0VO« 


|o 


: Input 


Ftoatlng point 


FL0VCIN2 


; 0 


mput 


Fbatino point 


FlbWrduTf 


: 0 ; Output 

;6 Output 


Ftoatlng point 


FLOVV.OITO ' 


Fbating point 


HT^ABSORBED, 0 


Internal read only 


Ftoatmg point 


m 


1 i mput I Fbating pobit array 






Input 

1 Z. , 


Fbating point array 


IM^STI 


i No_Ccnnect.. 


input 


teamed Set 




1 No.ConnecL.. 


input 


Named Set 


oinri 


1 


Output 


Ftoatlng point array 




! 


Output 


Ftoating point array 


0UT_ST1 


J No_Conncct.. 


Output 


Named Set 


0UT.ST2 


i Ho.Connect.. 


Output 


Named Set 


PIPE.CONSTI 




Intemai read only 


Ftoatlng point 


W>e^COMST2 


i? 


Internal read only 


Fteattog point 


^ .WtE^WI 


0 


input 


Floating pobit 


PRES^iz 


0 


input 


Ftoating point 


PRES.0UT1 


0 


Output 


Floating point 


PRES_0UT2 


0 


Output 


Ftoating point 




o"' 


tnput 


Ftoatlng point 


SPHT_W2 


. . 


Input 


Ftoating point 


sp*fr_ouTi 


0 i Output 


Ftoating potot 


SPH[iyblJT2 


0 f Output 


Ftoatlng point 


^ TEMP_IMl' *' " 


.0. . _..] 


mput 


Ftoating poht 




A 


' bipui 


Ftoatlng potot 


TEUP^OUTI " 


0_ _ Output 
0 foutput 


Ftoating point 


TEUP_0uf2 


Fbating point 


TRAHS.COEF 


1000 ; biiemal read only 

f ■ !■■"• 1 


Floating point 



HSAT_gXCH 









4.1 1 .2 Heat Exchange Algorithm - OutletTemperature and Heat Tranfer 
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IMF r"/aOWJNr<oaO) or (•"/flow IN?<BaO)THEN 

2 •"AEMP^OUir := '"/TEMP INV; 

3 '"/TEMP.OUT? •"/TEMP~IN7; 

4 •"/HT>BSORBEO' 0.0: 

5 ELSE 

6 N1 :o ( •"/TRANS.COEP • -"/EXCHG^EA- ) / ( -"/FLOWJNV • '"/SPHT INV ) ; 

7 N2 > ( -"ARANS.COEP • '"/EXCHG.AREA' ) / ( •"/FL0WJN7 • •"/SPHT IN? ) ; 

8 N3:oEXP(N2-N1l: 

91 •"/TEMP.OUT^ro ((Nai )-*"/TEMP INV* (1 Nl /N2) "-^/TEMP INZJ / (NB NI / N2); 
iq *"/TEMP_OUTV:o C N3- ( 1 •N1/N21 --"/TEMPJNV* (N1/N2) - TnS-I) •*"/TEMP IN?) / (N3-N1/N2)j 

11 '"/HT.ABSORBEO*:-*"/FLOWJNV"/SPHTJNV- I •"/TEMPJN V • •"/TEMP OUTV); " 

12 ENDIF: 



4.1 1 .3 Heat Exchange Algorithm - Flow and Pressure for Input 1 



|F{**/IN.STV= •PROC_ST:No.Conneclbn* ) THEN (Nf not connected. Ihen propagate value arid «l«lu»") 
•"/OUT^STl- :o PROC_ST:Good P_P; 
^ •"/PRES OUTV:o'"/PRES INl7 



ELSE 



•"/aOW.OUTl ' •"/FLOW INV; 
•^/BKCAU.OUT.PRESV :« •^ICCAL^IN.PRESV; 



IF ( •^/IN.STI • - TOOq.ST:Good.P ) THEN (• Constant fbw, propagate pressure fiow status 1 
& •"/0UT.ST1*:«*"/IN^STV; 
9 •"/PRES_OUTV:o»-/PRES INV; 

10 •"/FL0W.0UTV:=-"/FLQV7 INV; 

•"/BKCAL.OUT.PRESV := •"/BKCAL IN PRESV; 
ELSE 

IFC"/IN.STV«'PROC^ST:Good_P) THEN 

•^/FLOW^OUT V :» 0.0 ; (" No flow upstream, propagate press T 

•"/PRES.OUTV:- •"/PRES INV; 
•"/BKCAL.OUT^PRESV:- ^/BKCALJN.PRESV; 
•^/OUT.STV:«-"/lN STV; 
ELSE 



ENDIF; 
ENDIF; 
ENDIF; 



*"/FLOW^OUTV :« •"/FLOWJN V; f Calculale pipe outlet pressure -) 

•^/PRES.OUTV :o •"/PRES INV- (•"/FLOWJNV - '"/FLOWJN V ) • ""/PIPE CONSTVj 

•"/BICCAL OUT PRESV:o *^ " 

•"/OUT,STV:«'"/IN.STV; 



"•*>PRES INV, 



•"/DENS^OUTV:-^/DENS INV; 
•^/SPHTJUTI' :o •^/SPHTJNV; 



4.1 1.4 Heat Exchange Algorithm - Flow and Pressure for Input 2 



588 



1|IF[""/IN_ST7. PROq.ST:No.Connection') THEN (Nf not cormecCed then piopagate value and statutT 
H -^/OUT^ST? :- T>ROC_ST:GcotLP.r: 

3 -"/PRES OUTZ:.-"/PRES IN?: 

4 »"/FLOW OUT? ""/aOW IN?; 

5 *"^ICCaCOUT.PRESZ *^KCAU_IN_PRESZ; 
B ELSE 

7 IF ( •*/IN^ST V - 1>R0C_ST:Cq«LF* ) THEN (• ComtarH fte**. prcapagate ptessure dam status ') 

e *^yOUT ST?:«.*"/IN ST?; 

a '"/PRES.OUT? > -"/PRESJN?: 

10 •">FLOW.OUT?:-'^yn.OW IN?; 

1 1 *"yBICOU^0UT.PRES? :- "^KCALJN.PRES?; 

12 ELSE 

13 IF(*"/IN.ST?-'PROC^ST:Goo<LP') THEN 

1 4| *"/FtOW OUT? :« aO : (- No How upstream, propagate press ') 

15 -"/PRES.OUT?:- ""/PRES IN?; 

16 •^/BICCAI^OUT.PRES?:- ^/BKCAI^IN.PRES?; 

17 *"ADUT ST7:o-^/lN ST?; 

18 ELSE 

la ""/FLOW OUT? > •"/FLOWJN?; f CateuWe pipe outlel prwture ") 

20 -"/PRESrOUT? :o •^/PRES IN? • ( -"/FLOWJN? * -"/FLOWJN? ) ■ •"/PIPE.CONST? ; 

21 •^/BKCAU.DUT.PRES? */PRESJN?; 

22 •"/OUT.ST? -"/IN.ST?; 
ENOIF; 

ENDIF; 
i ENOIF; 
"/DENS OUT?:-**yOENSJN?; 
*/SPHT OUT? '"/SPHT IN?; 
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4.12 Variable Speed Pump Element 

The variable speed element is defined as a composite template. This block utilized the following 
parameters and algorithm. 

4.12.1 Variable Speed Pump Parameters 









SI8[FSrafn?teritype?^ ^^^^Sfej 


BKCAU.IH_P.,. 


0 


Input 


: Floattnfl point l 


BKCALJOUT..; 


0 t Output 


; Floating point ;'| 


DENS.W 


1000 i 


Input 


I ftoatoQ point | 


FUOW^W 


0 !..?i^^PM^ 

' 0 ' tnput 


" r I'd 
\ Ftoatlnjt^point ;i 

\ Floating point j 


fl6vvj.iax 




mtemal read ony 


I Floating point 


FLOW OUT 


0 


Output 


1 Ftoattng point 


IM ^ 


Input 


! Ftoattng point array 


IN 


f No.Connect.. 


tnput 


1 Named Set i 


OUT ; 


Output 


1 Floating point array 


OUT.ST 


; No.Connect.. 


Output 


1 Named Set J 




PRHS.IN _ 


0 


. Input 


i Floating point 


PRES.OUT 


0 


Output 


j Ftoattng point _ij 


PUMP^CONST 


BO 


< Internal read only 


i Floating point ;i 


PUMP^STATE 


On 


! tnput 


[ Named Set ij 


SPgED_PCT 


0 


1 tnput 


\ Ftoating^ojnt waah ato^ 


SPKl^W 
• SPHT.OUT* 


: 4.1B4 


1 Input 

; Output 


\ Ftoattng point j; 

1 Floating point 

; Floating point _ _ j. 


TEMP_IH_ 




' Input 


^ TEMP^UT " 




j Output 


^Floating point h 








\ 1 
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4.12.2 Variable Speed Pump Algorithm 

IFl**yiN_ST'«» PROC_ST:No_Conneclion') THEN C» If nol cotwwcsledl Ihen piopagate vahie and «talu»'| 



1C 

n 
ii 

13 
14 
15 
1G 
17 
18 
19 
20 
21 
22 
23 
24 
2S 
26 
27 
28 

2d 

30 
31 
32 
33 
34 
35 
38 
37 
38 
39 
40 



'•"/OUT ST*:-'PROClST:GoocLP.F: 
•"/PRES OUT*:-'"/PRESJN'; 
•"/FLOWlOUT' •"/FLOW IN*; 
'"/BKCAl.OUT.PRES' •^KCAI^IN.PRES*; 
ELSE 

IF ( ""/IN ST' o "PROC STiGowLP ) THEN (' Comlanl Itew. pjopagale piestuie flow status •) 
•"/oTjt^st' :« -"/liS.ST*: 
*"/PRES.OUT' :o -"/PRES JN*; 
•"/FLOW OUT':o*"/FLOWJN'; 
•"/8ICCAL OU TORRES' '^/BICCALJN.PRES': 
ELSE . 
IF I •"/PUMP STATE' - "MOTORiOfT ) THEN (" Detefmme if pump runrttntfl 

•"/FLOW OUT'- 00- (• MolOf off no flow possible ■) 

-/PRES "OUT* :» -"/BKCAL IN.PRES'; 
•"/BKCALOUT PRES*:«>^/PflESJN'; 
•"/OUT ST*:«'PROC_ST:GoocLP; 
ELSE 

IF ( ""/IN ST* o •pROC^STiGootLP' ) THEN . 
•"/FLOW OUT* » 0 0 : ("No flow upstream, ptopagata press J 

^/PRESjOUT':- -"/PRES IN*; 



^/iBKCALliuT'^PRES'-o ^/PRESJN'; 
ELSE 



"/o'uT_S'r •^/InIsT-; 



^/FLOW OUT' •"/FLOWJN'; 
FradionOpen:- (•"/SPEED per /lOaO); , ^ 

FI^^» ((FraclionOpcn- -/FLOW.MW) - •"/FLOWJN' ); (• Calculale dischar< 
IF(FIFackOf<aO)THEN 
FFactoi:«0.0; 

^iWIES OUr:«*"/PRESJN'*('"/PUMP.CONST') - SQRT( FFactor | « 
•"/BKCAUOUT^PRES*:- -"/PRESJN'; 
■"/OUt^ST':«'*/IN.ST'; 
ENDIF: 
ENDIF: 
ENOIF: 
ENDIF: 

•"/DENS OUT';»'"/OENSJN^: 



"/tempIout 

"/SPHT.OUT' 



•"/TEMPJN'; 
:-*"/SPHTJN*; 
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5 Appendix — Conversion Table 



The following conversion factors are taken from table B.9 from the NIST publication SP811, Guide to 
SI Units. These factors may be used In the process block algorithm to convert between US and 
Metric units. 



5.1 Area 



To convert from 


to 


Multiply by 


acre (based on U.S. survey foot) 


square meter (m^) 


4.046 873 


E+03 


hectare (ha) 


square meter (m^) 




E+04 


square foot (ft^) 


square meter (m^) 


9.290 304 


E-02 


square inch (in^) 


square meter (m^) 


6.4516 


E-04 


square inch (in^) 


square centimeter (cm^) 6.4516 


E+00 


square mile (mi^) 


square meter (m^) 


2.589 988 


E+06 


square mile (mi^) 


square kilometer (km^) 


2.589 988 


E+00 


square mile (based on U.S. survey foot) (mi^) 


square meter (m^) 


2.589 998 


E+06 


square mile (based on U.S. survey foot) (mi^) 


square kilometer (km^) 


2.589 998 


E+00 


square yard (yd^) 


square meter (m^) 


8.361 274 


E-01 



5.2 Energy (includes Work) 



To convert from 


to 


Multiply by 


British thermal unitrr (BtUrr) 


joule (J) 


1.055 056 


E+03 


British thermal unitth (BtUth ) 


joule (J) 


1.054 350 


E+03 


British thermal unit (mean) (Btu) 


joule (J) 


1.055 87 


E+03 


British thermal unit (39 ^F) (Btu) 


joule (J) 


1.059 67 


E+03 


British thermal unit (59 ®F) (Btu) 


joule (J) 


1.054 80 


E+03 


British thermal unit (60 °F) (Btu) 


joule (J) 


1.054 68 


E+03 


calorierr (calrr) 


joule (J) 


4.1868 


E+00 


caloricih (caU) 


joule (J) 


4.184 


E+00 


calorie (mean) (cal) 


joule (J) 


4.190 02 


E-fOO 


calorie (15 ''C) (cal,,) 


joule (J) 


4.185 80 


E+00 


calorie (20 **C) (ca^o) 


joule (J) 


4.181 90 


E+00 


calorierr, kilogram (nutrition) 12 


joule (J) 


4.1868 


E+03 


calorieth, kilogram (nutrition) 12 


joule (i) 


4.184 


E+03 


calorie (mean), kilogram (nutrition) 12 


joule (J) 


4,190 02 


E+03 


foot poundal 


joule (J) 


4.214 011 


E-02 


foot pound- force (ft • Ibf) 


joule (J) 


1.355 818 


E+00 


kilocalorieiT (kcalrr) 


joule (J) 


4.1868 


E+03 
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kilocalorieui (kcalui) 


joule (J) 


4.184 


E+03 


kitocalorie (mean) (kcal) 


joule (J) 


4.190 02 


E-H)3 


kilowatt hour (kW • h) 


joule (J) 


3.6 


E+06 


kilowatt hour(ky/ - h) 


megajoule (MJ) 


3.6 


E+00 


watt hour (W - h) 


joule (J) 


3.6 


E+03 


watt second ( W • s) 


joule (J) 


1.0 


E+00 



5.3 Force 



To convert from 


to 


Multiply by 


kilogram- force (kgf) 


newton (N) 


9.806 65 


E+00 


kilopond (kilogram-force) (kp) 


nevvton (N) 


9.806 65 


E+00 


kip(l kip» 1000 IbO 


newton (N) 


4.448 222 


E+03 


kip(l kip= 1000 Ibf) 


kilonewton (kN) 


4.448 222 


E+00 


ounce (avoirdupois)-force (ozO 


newton (N) 


2.780 139 


E-Ol 


,poundal 


newton (N) 


1.382 550 


E-01 


pound-force (Ibf) 24 


newton (N) 


4.448 222 


E+00 


pound-force per pound (Ibf/lb) (thrust to mass ratio) 


newton per kilogram (N/kg) 


9.806 65 


E+OO 


ton-force (2000 IbQ 


newton (N) 


8.896 443 


E+03 


ton-force (2000 IbQ 


kilonewton (kN) 


8.896 443 


E+00 



5.4 Heat (Available Energy) 



To convert from 



to 



Multiply by 



British thermal unitu per cubic foot (Bturr/ft^) 
British thermal unitth per cubic foot (BtUtb/ft^) 
British thermal unitrr per pound (Bturr/lb) 
British thermal unitu, per pound (Btuu/lb) 
catoricrr per gram (calir/g) 
calorieth per gram (calu/g) 



joule per cubic meter (J/m^) 3.725 895 E+04 

joule per cubic meter (J/m^) 3.723 403 E+04 

joule per kilogram (J/kg) 2326 E+03 

joule per kilogram (J/kg) 2.324 444 E+03 

joule per kilogram (J/kg) 4.1868 E+03 

joule per kilogram (J/kg) 4.1 84 E+03 



5.5 Coefficient of Heat Transfer 



To convert from 



to 



Multiply by 



British thermal unitiT per hour square foot degree Fahrenheit 
[Btun/(h • fV" ' op)] 

British thermal unitu, per hour square foot degree Fahrenheit 
[Btueh/(h ■ ft^ ■ ^F)] 

British thermal unitrr per second square foot 
degree Fahrenheit [Bturr/(s • ft^ • *»?)] 
British thermal unitth per second square foot 
degree Fahrenheit [BtU(h/(5 • ft^ • *F)] 



watt per square meter kelvln 
[W/(m2 • K)] 

watt per square meter kelvin 
[W/(m^ • K)] 

watt per square meter kelvin 
[W/(ni^ • K)] 

watt per square meter kelvin 
[W/{m* • K)] 



5.678 


E+00 


263 




5.674 


E+00 


466 




2.044 


E+04 


175 




2.042 


E+04 


808 
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5.6 Density of Heat Flow Rate 

To convert from 



to 



Multiply by 



British thermal unitn* per square foot hour [Bturr/(A^ * h)] 
British thermal unitth per square foot hour [Btua/(ft^ * h)] 
British thermal unitth P^r square foot minute [BtU|h/(ft^ * min 
British thermal unitrr per square foot second [BtUiT/(fl* ' s)] 
British thermal unitui per square foot second [BtUti/(fl^ * s)] 



calorieoi per square centimeter minute [calu/(cm^ • min)] 
calorieih per square centimeter second [calth/(cm^ * s)] 



5.7 Heat Capacity and Entropy 

To convert from to 



watt per square meter (W/m*) 


3.1S4 591 


E+00 


watt per square meter (W/m^) 


3.152 481 


E+00 


watt per square meter (W/m^) 


1.891 489 


E+02 


watt per square meter (W/m^) 


1.135 653 


E+04 


watt per square meter (W/m^) 


1.134 893 


E+04 


watt per square meter (W/m^) 
watt per square meter (W/m^) 
watt per square meter (W/m^) 


1.634 246 
6.973 333 
4.184 


E+06 
E+02 
E+04 



Multiply by 



British thermal unil,T per degree Fahrenheit (BtUrr/^F) joule per kelvin (J/k) 1.899 lOl E+03 

British thermal unittf, per degree Fahrenheit (BtUth/**F) joule per kelvin (J/k) 1 .897 830 E+03 

British thermal unitrr per degree Rankine (Bturr/^R) joule per kelvin (J/k) 1 .899 1 01 E+03 

British thermal unito, per degree Rankine (Btuu,/*R) joule per kelvin (J/k) 1 .897 830 E+03 



5.8 Heat Flow Rate 



To convert from to 


Multiply by 






British thermal unitjT per hour (Bturr/h) 


watt (W) 


2.930 711 


E-01 


British thermal unitth per hour (BtUij/h) 


watt (W) 


2.928 751 


E-01 


British thermal unitth per minute (BtU|h/min) 


watt ( W) 


1.757 250 


E+01 


British thermal unitrr per second (Btuir/s) 


watt (W) 


1,055 056 


E+03 


British thermal unitth per second (BtUtf|/s) 


watt (W) 


1.054 350 


E+03 


calorie,h per minute (calo/min) 


watt (W) 


6.973 333 


E-02 


caloricth per second (calu/s) 


watt(W) 


4.184 


E+00 


kilocaloricth per minute (kcalth/min) 


watt (W) 


6.973 333 


E+OI 


kilocaloricth per second (kcalth/s) 


watt ( W) 


4.184 


E+03 


ton of refrigeration (12 000 Bturr/h) 


watt (W) 


3.516 853 


E+03 
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5.9 Specific Heat Capacity and Specific Entropy 

To convert from to 



Multiply by 



British thermal unitrr per pound degree Fahrenheit [Btun/(lb joule per kilogram kelvin [J/(kg • 4.1868 E+03 



-F)] 



K)] 



British thermal unit* per pound degree Fahrenheit [BtUih/(lb • joule per kilogram kelvin [J/(kg * 4.184 E+03 



-F)l 

calorierr per gram degree Celsius [calrr/Cg • *C)1 
calorieih per gram degree Celsius [ca1th/(g * **C)] 



K)] 

joule per kilogram kelvin [J/(kg • 4.1868 E+03 
K)] 

joule per kilogram kelvin [J/(kg • 4.184 E+03 
K)] 



5.10 Thermal Conductivity 



To convert from 



to 



Multiply by 



Dritsh thermal unitrr foot per hour square foot degree Fahrenheit 
[BtUiT • ft/(h • fl^ • °F)] 

Britsh thermal unit* foot per hour square foot degree Fahrenheit 
[Btuth • ft/(h • ft' • °F)] 

Britsh thermal unitrr inch per hour square foot degree Fahrenheit 
[Bturr • in/(h • ft^ • *»F)] 

Britsh thermal unit^ inch per hour square foot degree Fahrenheit 
[BtUih ' in/(h ■ ft' • **F)] 

Britsh thermal unitrr inch per second square foot degree Fahrenheit 
[Bturr • in/(s • ft^ • «»F)] 

Britsh thermal unitu, inch per second square foot degree Fahrenheit 
[BtUth • in/(s • ft' • ^'F)] 

calorieu, per centimeter second degree Celsius (calu/(cm • s • **C)] 



watt per meter kelvin 


1.730 


E+00 


[W/(m • K)] 


735 




watt per meter kelvin 


1.729 


E+00 


[W/(m ■ K)] 


577 




watt per meter kelvin 


1.442 


E-Ol 


[W/(mK)] 


279 




watt per meter kelvin 


1.441 


E-01 


[W/(m • K)] 


314 




watt per meter kelvin 


5.192 


E+02 


[W/(m • K)] 


204 




watt per meter kelvin 


5.188 


E+02 


[W/(m • K)] 


732 




watt per meter kelvin 


4.184 


E+02 


[W/(m • K)] 







5.11 Thermal Insulance 



To convert from 



to 



Multiply by 



degree Fahrenheit hour square foot per British thermal unitir square meter kelvin per watt 
(^'F ' h • ft'/BtUir) ("1^ • K/^) 

degree Fahrenheit hour square foot per British thermal unitu, ("F square meter kelvin per watt 
•h-ft^/BtUo.) (m'K/W) 



1.761 
102 

1.762 
280 



E- 
01 
E- 
01 



5.12 Thermal Resistance 



Thermal Resistance 

To convert from to Multiply by 



degree Fahrenheit hour per British thermal unil,T (**F • h/BtUir) kelvinper watt (K/W) 1 .895 634 E+00 
degree Fahrenheit hour per British thermal unity, (^'F • h/BtUth) kelvinper watt (K/W) 1 .896 903 E+00 
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degree Fahrenheit second per British thermal unitn- (**F • s/Bturr) kelvinper watt (K/W) 5.265 651 E-04 
degree Fahrenheit second per British thermal unit^h (**F • s/BtU|h) kelvinper watt (K/W) 5.269 175 E-04 



5.13 Thenfnal Resistivity 



To convert from 



to 



Multiply by 



degree Fahrenheit hour square foot per British thermal unitix inch [**F meter kelvin per watt (m 6.933 E+OO 

• h • ft^/(BtUrr • in)] -K/W) 472 

degree Fahrenheit hour square foot per British thermal unitth inch [^F meter kelvin per watt (m 6.938 E+04 

• h • ftV(BtUA • in)] K/W) 112 



5.14 Length 



To convert from 



to 



Multiply by 



foot (ft) 


meter (m) 


3.048 


E-01 


foot (U.S. survey) (ft) 


meter (m) 


3.048 006 


E-01 


inch (in) 


meter (m) 


2.54 


E-02 


inch (in) 


centimeter (cm) 


2.54 


E+OO 


mil (0.001 in) 


meter (m) 


2.54 


E-05 


mil (0.001 in) 


millimeter (mm) 2.S4 


E-02 


mile (mi) 


meter (m) 


1.609 344 


E+03 


mile (mi) 


kilometer (km) 


1.609 344 


E-MIO 


yard (yd) 


meter (m) 


9.144 


E-01 



5.15 IVIass 



To convert from 



to 



Multiply by 



hundredweight (long, 1 12 lb) 
hundredweight (short, 100 lb) 

kilogram-force second squared per meter (kgf * sVm) 
pound (avoirdupois) (lb) 23 
pound (troy or apothecary) (lb) 
pound foot squared (lb • ft^) 
.pound Inch squared (lb 
ton, assay (AT^ 
ton, assay (AT) 
ton, long (2240 lb) 
ton, metric (t) 



in^) 



kilogram (kg) 5.080 235 E+01 

kilogram (kg) 4,535 924 E+01 

kilogram (kg) 9.806 65 E+OO 

kilogram (kg) 4.535 924 E-Ol 

kilogram (kg) 3.732 417 E-Ol 

kilogram meter squared (kg • m^) 4.214 01 1 E-02 

kilogram meter squared (kg • m^) 2.926 397 E-04 

kilogram (kg) 2.916 667 E-02 

gram(g) 2.916 667 E+01 

kilogram (kg) 1 .01 6 047 E+03 

kilogram (kg) 1.0 E+03 
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tonne (called "metric ton" in U.S.) (t) 
ton. short (2000 lb) 



kilogram (kg) 
kilogram (kg) 



1.0 E-K)3 
9.071 847 E+02 



5.16 Mass Divided by Time (includes Flow) 



To convert from 



to 



Multiply by 



pound per hour (Ib/h) 
pound per minute (Ib/min) 
pound per second (ib/s) 
ton, short, per hour 



kilogram per second (kg/s) 1 .259 979 E-04 

kilogram per second (kg/s) 7.559 873 E-03 

kilogram per second (kg/s) 4.535 924 E-01 

kilogram per second (kg/s) 2.519 958 E-Ol 



5.17 IMass Divided by Volume (includes Mass Density and Concentration) 



To convert from 



to 



Multiply by 



pound per cubic foot (Ib/tf) 
pound per cubic inch (Ib/in^) 
pound per cubic yard (Ib/yd^) 
pound per gallon [Canadian and U.K. 
pound per gallon [Canadian and U.K. 
pound per gallon (U.S.) (lb/gal) 
pound per gallon (U.S.) (lb/gal) 
slug per cubic foot (slug/fl^) 
ton, long, per cubic yard 
ton, short, per cubic yard 



kilogram per cubic meter 
kilogram per cubic meter 
kilogram per cubic meter 
(Imperial)] (lb/gal) kilogram per cubic meter 
(Imperial)] (lb/gal) kilogram per liter (kg/L) 
kilogram per cubic meter 
kilogram per liter (kg/L) 
kilogram per cubic meter 
kilogram per cubic meter 
kilogram per cubic meter 



(kg/m^) 1.601 846 E+Ol 
(kg/m^) 2.767 990 E+04 
(kg/m^) 5.932 764 E-01 
(kg/m^) 9.977 637 E+01 

9.977 637 E-02 
(kg/m') M 98 264 E+02 

1.198 264E-0I 
(kg/m^) 5.153 788 E+02 
(kg/m') 1.328 939 E+03 
(kg/m^) 1.186 553 E+03 



5.18 Power 



To convert from 


to 


Multiply by 


foot pound-force per hour {ft - Ibf/h) 


watt (W) 


3.766 161 


E-04 


foot pound-force per minute (fl • Ibf/min) 


watt (W) 


2.259 697 


E-02 


foot pound-force per second (ft • Ibf/s) 


watt (W) 


1.355 818 


E+00 


horsepower (550 ft * Ibf/s) 


watt(W) 


7.456 999 


E+02 


horsepower (boiler) 


watt (W) 


9.809 50 


E+03 


horsepower (electric) 


watt (W) 


7.46 


E+02 


horsepower (metric) 


watt (W) 


7.354 988 


E+02 


horsepower (U.K.) 


watt (W) 


7.4570 


E+02 


horsepower (water) 


watt (W) 


7.460 43 


E+02 
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5.19 Pressure or Stress (Force divided by area) 



To convert from to Multiply by 



atmosphere, standard (atm) 


pascal (Pa) 


1.013 25 


E+05 


atmosphere, standard (atm) 


kilopascal (kPa) 


1.013 25 


E-H)2 


atmosphere, technical (at) 


pascal (Pa) 


9.806 65 


E+04 


atmosphere, technical (at) 


kilopascal (kPa) 


9.806 65 


E+01 


bar (bar) 


pascal (Pa) 


1.0 


£+05 


bar (bar) 


kilopascal (kPa) 


1.0 


E+02 


centimeter of mercury (0 **€) 


pascal (Pa) 


1.333 22 


E+03 


centimeter of mercury (0 **C) 


kilopascal (kPa) 


1,333 22 


E+00 


centimeter of mercury, conventional (cmHg) 


pascal (Pa) 


1.333 224 


E+03 


centimeter of mercury, conventional (cmHg) 


kilopascal (kPa) 


1.333 224 


E+00 


centimeter of water (4 **C) 


pascal (Pa) 


9.806 38 


E+01 


centimeter of water, conventional (cmH20) 


pascal (Pa) 


9.806 65 


E+01 


dyne per square centimeter (dyn/cm^) 


pascal (Pa) 


1.0 


E-01 


foot of mercury, conventional (ftHg) 


pascal (Pa) 


4.063 666 


E+04 


foot of mercury, conventional (flHg) 


kilopascal (kPa) 


4.063 666 


E+01 


foot of water (39.2 ^F) 


pascal (Pa) 


2.988 98 


E+03 


foot of water (39.2 ^F) 


kilopascal (kPa) 


2.988 98 


E+00 


foot of water, conventional (ftHjO) 


pascal (Pa) 


2.989 067 


E+03 


foot of water, conventional (ftH20) 


ikilopascal (kPa) 


2.989 067 


E+00 


gram -force per square centimeter (g£7cm^) 


pascal (Pa) 


9.806 65 


E+01 


inch of mercury (32 *F) 


pascal (Pa) 


3.386 38 


E+03 


inch of mercury (32 ®F) 


kilopascal (kPa) 


3.386 38 


E+00 


inch of mercury (60 °F) 


pascal (Pa) 


3.376 85 


E+03 


inch of mercury (60 *F) 


kilopascal (kPa) 


3.376 85 


E+00 


inch of mercury, conventional (inHg) 


pascal (Pa) 


3.386 389 


E+03 


inch of mercury, conventional (inHg) 


kilopascal (kPa) 


3.386 389 


E+00 


inch of water (39.2 ^F) 


pascal (Pa) 


2.490 82 


E+02 


inch of water (60 ®F) 


pascal (Pa) 


2.4884 


E+02 


inch of water, conventional (inH20) 


pascal (Pa) 


2.490 889 


E+02 


kilogram- force per square centimeter (kgf/cm^) 


pascal (Pa) 


9.806 65 


E+04 


kilogram-force per square centimeter (kg£<cm^) 


kilopascal (kPa) 


9.806 65 


E+01 


kilogram- force per square meter (kgf/m^) 


pascal (Pa) 


9.806 65 


E+00 


kilogram- force per square millimeter (kgf/mm^) 


pascal (Pa) 


9.806 65 


E+06 


kilogram-force per square millimeter (kgf/mm^) 


megapascal (MPa) 


9.806 65 


E+00 


kip per square, inch .(ksi).(kip/in?) 


.pascal (Ba) - - 


- 6.894 757- 


.E+06. 


kip per square inch (ksi) (kip/in^) 


kilopascal (kPa) 


6.894 757 


E+03 


millibar (mbar) 


pascal (Pa) 


l.O 


E+02 


millibar (mbar) 


kilopascal (kPa) 


1.0 


E-01 


millimeter of mercury, conventional (mmHg) 13 


pascal (Pa) 


1.333 224 


E+02 


millimeter of water, conventional (mmHiO) JJ. 


pascal (Pa) 


9.806 65 


E+00 
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poundal per square foot 


pascal (Pa) 


1.488 164 


E+OO 


pound-force per square foot (!bf7ft^) 


pascal (Pa) 


4.788 026 


E+OI 


pound- force per square inch (psi) (Ibf/in^) 


pascal (Pa) 


6,894 757 


E+03 


pound-force per square inch (pst) (ibf/in ) 


kilopascal (icPa) 


0.0^4 757 


t+uu 


psi (pound-force per square inch) (Ibf/in^) 


pascal (Pa) 


6.894 757 


£403 


psi (pound-force per square inch) (Ibf/in^) 


kilopascal (kPa) 


6.894 757 


E+00 


torr (Torr) 


pascal (Pa) 






5.20 Temperature 








To convert from to 


Multiply by 







degree Celsius (*»C) kclvin (K) T/K = //**C + 273.15 

degree centigrade i6 degree Celsius (**C) ^^oq j^/deg. cent, 

degree Fahrenheit C'F) degree Celsius (°C) //*C = (//**F - 32)/l.8 

degree Fahrenheit (°F) kelvin (K) r/K = (//*F + 459.67)/!. 8 

degree Rankine (*R) kelvin (K) 7/K = (r/°R)/1.8 

kelvin (K) degree Celsius («C) r/*»C « TVK - 273.1 5 

5.21 Temperature Interval 



To convert from to Multiply by 



degree Celsius (*'C) 


kelvin (K) 


1.0 


E+00 


degree centigrade 16 


degree Celsius (°C) 


1.0 


E+00 


degree Fahrenheit (®F) 


degree Celsius (^'C) 


5.555 556 


E-Ol 


degree Fahrenheit (**F) 


kelvin (K) 


5.555 556 


E-01 


degree Rankine CR) 


kelvin (K) 


5.555 556 


E-01 



5.22 Time 



To convert from to Multiply by 



day {6) 


second (s) 


8.64 


£+04 


day (sidereal) 


second (s) 


8.616 409 


E+04 


hour (h) 


second (s) 


3.6 


E+03 


hour (sidereal) 


second (s) 


3.590 170 


E+03 


minute (min) 


second (s) 


6.0 


E+01 


minute (sidereal) 


second (s) 


5.983 617 


E+01 


second (sidereal) 


second (s) 


9.972 696 


E-01 


shake 


second (s) 


1.0 


E-08 


shake 


nanosecond (ns) 


1.0 


E+01 


year (365 days) 


second (s) 


3.1536 


E+07 


year (sidereal) 


second (s) 


3.155 815 


E+07 
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year (tropical) second (s) 3.155 693 E+07 

5.23 Velocity (includes Speed) 



To convert from 



to 



Multiply by 



foot per hour (ft/h) 

foot per minute (ft/min) 

foot per second (ft/s) 

inch per second (in/s) 

kiiomeier per hour (km/h) 

knot (nautical mile per hour) 

mile per hour (mi/h) 

mile per hour (mi/h) 

mile per minute (mi/min) 

mile per second (mi/s) 

revolution per minute (rpm) (r/min) 

rpm (revolution per minute) (r/min) 



meter per second (m/s) 
meter per second (m/s) 
meter per second (m/s) 
meter per second (m/s) 
meter per second (m/s) 
meter per second (m/s) 
meter per second (m/s) 
kilometer per hour (km/h) 
meter per second (m/s) 
meter per second (m/s) 
radian per second (rad/s) 
radian per second (rad/s) 





E-05 


5.08 


E-03 


3.048 


E-01 


2.54 


E-02 


2.777 778 


E-01 


5.144 444 


E-01 


4.4704 


E-01 


1.609 344 


E+00 


2.682 24 


E+01 


1.609 344 


E+03 


1.047 198 


E-01 


1.047 198 


E-01 



5.24 Viscosity, Dynamic 



To convert from 


to 




Multiply by 


centipoise (cP) 


pascal second (Pa * 


s) 


1.0 


E-03 


poise (P) 


pascal second (Pa • 


s) 


1.0 


E-01 


poundal second per square foot 


pascal second (Pa ■ 


s) 


1.488 164 


E+00 


pound-force second per square foot (Ibf • s/ft^) 


pascal second (Pa 


s) 


4.788 026 


E+01 


pound-force second per square inch (Ibf* s/in^) 


pascal second (Pa ■ 


s) 


6.894 757 


E+03 


pound per foot hour [lb/(it - h)] 


pascal second (Pa - 


s) 


4.133 789 


E-04 


pound per foot second [lb/(ft - s)] 


pascal second (Pa 


s) 


1.488 164 


E+00 


rhe 


reciprocal pascal second [(Pa • s)'*] 


1.0 


E+01 


slug per foot second [slug/(ft - s)] 


pascal second (Pa 


•s) 


4.788 026 


E+01 



5.25 Viscosity, Kinematic 



To convert from 



to 



Multiply by 



centistokes (cSt) meter squared per second (mVs) 1.0 E-06 

square foot per second (ftVs) meter squared per second (mVs) 9.290 304 E-02 
stokes (St) meter squared per second (mVs) 1.0 E-04 
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5.26 Volume (includes Capacity) 



To convert from 


to 


Multiply by 


acre-foot (based on U.S. survey foot) 9 


cubic meter (m^) 


1.233 489 


E+03 


barrel [for petroleum, 42 gallons (U.S.)](bbl) cubic meter (m^) 


1.589 873 


E-01 


barrel [for petroleum, 42 gallons (U.S.)](bbl) 


liter (L) 


1,589 873 


E+02 


cubic foot (ft^) 


cubic meter (m^) 


2.831 685 


E-02 


cubic inch (in^) 14 


cubic meter (m^) 


1.638 706 


E-05 


cubic mile (mi^) 


cubic meter (m^) 


4.168 182 


E+09 


cubic yard (yd^) 


cubic meter (m*) 


7.645 549 


E-Ol 


gallon [Canadian and U.K. (Imperial)] (gal) 


cubic meter (m^) 


4.546 09 


E-03 


gallon [Canadian and U.K. (Imperial)] (gal) 


liter (L) 


4.54i5 09 


E+06 


gallon (U.S.) (gal) 


cubic meter (m^) 


3.785 412 


E-03 


gallon (U.S.) (gal) 


liter (L) 


3.785 412 


E+00 


iiter (L) 20 


cubic meter (m^) 


1.0 


E.03 


ton, register 


cubic meter (m') 


2.831 685 


E+00 



5.27 Volume Divided by Time (includes Flow) 



To convert from 



to 



Multiply by 



cubic fool per minute (fl /min) 

cubic foot per minute (ftVmin) 

cubic foot per second (ft'/s) 

cubic inch per minute (inVmin) 

cubic yard per minute (ydVmin) 

gallon (U.S.) per day (gal/d) 

gallon (U.S.) per day (gal/d) 

gallon (U.S.) per minute (gpm) (gal/min) 

gallon (U.S.) per minute (gpm) (gal/min) 



cubic meter per 
liter per second 
cubic meter per 
cubic meter per 
cubic meter per 
cubic meter per 
liter per second 
cubic meter per 
liter per second 



second (m /s) 
(l^s) 

second (m^/s) 
second (mVs) 
second (m^/s) 
second (m^/s) 
(L/s) 

second (m^/s) 
(L/s) 



4.719 474 
4.719 474 
2.831 685 
2.731 177 
1.274 258 
4.381 264 
4.381 264 
6.309 020 
6.309 020 



£-04 
E-01 
E-02 
E-07 
E-02 
£-08 
E-05 
E-05 
E-02 



601 



1. Display 

Display - things that you can define as part of the display 

Edit Dynamics - any static item can be turned into a dynamic item. When 
this happens the user then defines a tag and later defines what they want the dynamic 
behavior to be. 

UI Controls 

Button, Check-box, Slider, etc 
Behaviors 

Action, Alert (attach a data mapping) 
Conditions 

If, Switch 
Element 

Copy, Create, Move, Replace 
Listener (register for an event and take action when the event arrives) 
LoadURL 
LoadXML 
printElement 
Attributes 

Context Menu, Drag/Drop, Focus, Tool tip. Zoom and Span, Share 
Elements 

Shape Elements 

Rectangle, Circle, Ellipse, Line, Polygon, Polylines, Path 
Container Elements 

Svg, Group, Symbols 
Text Elements 

Text, Text path 
Reference Elements 

Image 
Other Elements 

Script, PCDATA, description 
Cut/Copy/Paste/Delete Nodes 
Move to Back/Front 
Move One Forward/Backward 
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2. Groups 

Step 1 : Create Inputs and Outputs 

Step 2 : Define Functionality for each of the Dynamic Elements (the elements that 
were given dynamic behavior are defined when the display is built) 

Step 3 : Bind Inputs and Outputs to the Functionality associated with each Dynamic 
Element 



3. Data Bindings 

Bind inputs and outputs to Data Source 



4. Data Binding Sources 

The sources of the information that we bind to should be 



1- 


DeltaV Runtime 


2- 


DeltaV Historian 


3- 


OPC 


4- 


XML File 


5- 


HTTP Browse Link 


6- 


Alium Services 


7- 


Event Services 


8- 


General Web Services 


9- 


Yukon Managed Runtime (ADO interface) 
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